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拱 兴建 | 建 入 电 程 环境 
1.1.1 Python 版 本 

1.1.2 ”运行 Python 代码 片段 
1.1.3 ”Sublime Text 人 简介 
在 不 同 操作 系统 中 搭建 Python 编程 环境 


ti 中 搭建 Python 编程 环境 
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1.2.2 ”在 macOS 系 统 中 搭建 Python 编程 环境 
1.2.3 ”在 Linux 系 统 中 搭建 Python 编程 环境 
1.3 ”运行 Hello World 程 序 

1.3.1 配置 Sublime Text 以 使 用 正确 的 Python 版 本 
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1.5.2 ”在 Linux 和 macOS 系 统 中 从 终端 运行 Python 程序 


1.6 
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4.3 
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4.2.1 忘记 缩 进 
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while 特 环 下 简介 
使 用 while 循 和 
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7.3.3 ”使 用 用 户 输 入 来 填充 字典 


小 结 


0 


定义 函数 
8.1.2” 实 参 和 形 参 


传递 实 参 


8.2.3 ”默认 值 
De 
8.3 返回 值 


有 
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8.5.2 ”使 用 任意 数量 的 关键 字 实 参 
8.6 


8.7 
9.1 创建 和 使 用 类 类 
9.1.1 ek ; 


52 使 用 类 和 实例 
9.2.1 ”Car 类 


9.4.4 从 -人 生息 
导入 模块 中 的 所 有 类 
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文件 和 异常 

从 文件 中 读 取 数 据 
10.1.1 读 取 整个 文件 

10.1.2 文件 路 径 

10.1.3” 逐 行 读 取 

10.1.4 创建 一 个 包含 文件 各 行内 容 的 列表 
10.1.5 ”使 用 文件 的 内 容 

10.1.6 包含 一 百 万 位 的 大 型 文件 


10.1.7 圆周率 值 中 包含 你 的 生日 吗 
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10.2.1 写 入 空 文件 

10.2.2 写 入 多 行 

10.2.3 ”附加 到 文件 
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10.3.1 id 常 
10.3.2 
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10.3.4 
10.3.6 分析 文本 
10.3.7 ”使 用 多 个 文件 
10.3.8 静默 失败 
on 


10.4 


10.4.3 重 构 
10.5 ”小结 
第 11 章 测试 代码 
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11.1.4 测试 未 通过 时 怎么 办 
11.1.5 添加 新 测试 
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11.2.1 灯 言 方 ; 
11,2.2 一 个 要 测试 的 类 
11.2.3 测试 AnonymousSurvey 类 
11.2.4 ”方法 setUp() 
11.3 ”小结 
第 二 部 分 项 目 
项 目 1 外 星人 入 侵 
第 12 章 武装 飞船 
12.2 ”安装 Pygame 
12.3 ”开始 游戏 项 上 
12.3.1 创 建 Pygame 窗 窗口 及 响应 用 户 输入 


添加 飞船 图 像 
12.4.1 创建 Ship 类 
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方法 _update_screen() 
12.6 驾驶 飞船 
12.61 响 应 按键 
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12.7.1 alien_invasion.py 
12.7.2 settings.py 
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12.8.6 限制 子弹 数量 
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12.9 小 结 
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13.2.2 和 建 Alien 实 例 
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13.4 得 移动 
13.41 向 右 移动 外 星人 群 
13.4.2 抽 建 表示 外 星人 移动 方向 的 设置 


13.4.4 向 下 移动 外 星人 群 并 改变 移动 方 揣 
13.5 射 杀 外 星人 
LL lin 本 人 
13.5.2 ”为 测试 创 
135 4 提 高 子弹 的 速度 
13.5.5 ” 重 构 _update_bullets() 
13.6 ”结束 游戏 
13.6.1 检 洲 , 船 碰撞 
13.6.2 响应 dn 
13.6.3 ese 幕 底 端 


7 :村 ee 
13.8 ”小结 


有 游戏 四 
重 置 游戏 
MA 


14.2 和 高 等 有 
14.2.1 人 


14.3.1 显示 得 分 
14.3.2 ”创建 记分 牌 


ee C0 
14.3.4 
1435 将 消灭 的 每 个 外 星人 都 计 入 得 分 
14.3.6 ”提高 分 数 
下 37 车 大 但 分 
14.3.8 ”最 高 得 分 
14.3.9 ”显示 等 级 
14.3.10 “显示 余下 的 飞船 数 

14.4 ”小结 
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线条 粗细 


使 用 公制 散 点 图 并 设置 样式 
代用 ee 制 一 系列 点 


自动 保存 图 表 
15.3 贿 机 渴 步 


15.3.4 ， 所 和 多 随机 上 


设置 随机 漫步 图 的 样式 


15.4 ”使 用 Plotly 模 拟 掷 则 


15.5 小结 
第 16 章 下 载 数 据 

16.1 CSV 文 件 格 式 
16.1.1 分 析 CSV 文 件 头 
16.1.2 ”打印 文件 头 及 其 位 置 
16.1.3 pe tan 
16.1.4 ”绘制 温 月 
16.1.5 
16.1.6 
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16.1.8 
16.1.9 或 并 
16.1.10 ”错误 检查 
16.1.11 自己 动手 下 载 数据 
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16.2.1 ei 
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16.2.3 
16.2.4 
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定制 标记 的 尺寸 


18.3” 小结 
第 17 章 ”使 用 API 
17.1 使 用 Web API 
17.1.1 Git 和 GitHub 
17.1.2 ”使 用 API 调 用 请 求 数据 
17.1.3 ”安装 Requests 
17.1.4” ”处理 API 响 应 
17.1.5” ”处理 响应 字典 
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17 4 小结 
项 目 3 Web 应 用 程序 
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19.2.3 包含 users 的 URL 
19.2.4 登录 页 面 
19.2.5 ”注销 
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9.3.2 ”将 数据 关联 到 用 户 
19.3.3 ”只 允许 用 户 访 问 目 己 的 主题 
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19.3.5 ”保护 页 面 edit_entry 
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20.2.4 创建 文件 requirements.txt 
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20.2.12 
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20.2.14 
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20.3 小 结 


指定 Python 版 本 
为 部 署 到 Heroku 而 修改 settings.py 
创建 启动 进程 的 Procfile 
使 用 Git 跟 踊 项 目 文 件 
推送 到 Heroku 
在 Heroku 上 建立 数据 库 
改进 Heroku 部 署 
提交 并 推送 修改 
JR 况 变 量 


设置 SEaRiEy: KEY 
将 项 目 从 Heroku 删 除 


附录 A ”安装 与 故障 排除 
A.l1 Windows 系 统 
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受 父 杀 影响 ，5 岁 的 埃 里 元 : 马 琴 斯 开始 编写 
| 个 简单 的 猜 数字 游戏 。 从 孩童 时 期 开始 ， 编 程 带 给 马 小 其 的 浇 忆 证 _ 寺 
影响 至 今 。30 岁 时 ， 作 为 Python 爱好 者 ， 他 开始 在 技术 社区 中 义务 教 
授 Python。 源 于 对 Python 的 好 奇 心 ， 他 的 儿子 Ever 每 天 不 断 提 问 ， 这 
才 驱 使 他 有 了 写作 本 书 的 想法 。 所 以 ， 与 其 说 它 是 一 本 书 ， 倒 不 如 说 它 
是 对 父子 两 代 人 编程 初 心 的 传承 。 


英文 书 名 进一步 阐述 了 本 书 的 意图 ，Python Crash Course: A Hands-On,， 

Project-Based Introduction to Programming 直译 过 来 的 意思 是 “Python 速 

成 教程 :动手 操作 、 基 于 项 目的 编程 入 门 ” 从 书 名 来 看 ， 它 并 不 是 真 

-0 与 大 学 计算 机 系 的 正统 编程 语言 教材 相 比 ， 它 最 大 的 
回避 仁 本 : 


。 实践 为 主 (hands-on ) 
。 项 目 为 纲 (project-based ) 


如 今 ， 随 着 互联 网 产业 的 高 速 发 展 ， 在 网 络 上 早已 积累 了 极其 丰富 的 
Python 学 习 资 料 ， 任 何人 都 可 以 基于 这 些 资 源 ， 自 学 掌握 Python。 但 实 
际 上 ， 网 络 上 充斥 的 资源 太 多 、 太 杂 且 不 成 体系 ， 在 没有 足够 的 编程 / 
工程 经 验 之 前 ， 仪 靠 “ 看 ” 线 上 资源 自学 ， 的 确 是 一 件 非常 困难 的 事 。 


当年 ， 大 妈 自 己 光 是 开发 第 一 个 实用 工具 (一 个 不 超过 50 行 代码 的 项 
和 就 前 后 用 了 将 近 半 年 的 时 间 才 得 以 成 功 。 之 所 以 耗 时 这 么 久 ， 原 
于 于 : 


。 9 过 全 ， 学 习 曲 线 陡峭 ， 更 适合 有 经 验 的 软件 
工程 师 ; 
。 面 癌 初 学 者 的 教程 只 讲 基础 语法 ， 并 没有 关于 项 目的 实践 引导 。 


20 多 年 过 去 了 ， 市 面 上 一 直 不 乏 各 种 教授 “ 零 基 础 入 门 Python” 的 图 

书 ， 但 至 今 只 有 两 本 摸 到 了 门 往 。 一 本 是 《条 办 法 学 Python》 ， 通 过 
极其 精练 的 针对 性 练习 ， 帮 助 小 白 突破 对 编程 的 恐惧 ， 但 遗憾 的 是 ， 它 
并 没有 包含 如 何 完成 实用 工程 的 内 容 。 另 外 一 本 ， 就 是 这 本 “Python 蟒 


AAA 


蛇 书 ”。 得 荔 于 中 学 老师 的 身份 ， 作 者 平时 接触 的 都 是 非 计算 机 专业 的 
学 生 。 他 结合 目 己 的 教学 经 历 ， 撰 写 了 这 本 从 零 开 始 快速 上 手 Python 
的 好 书 。 更 令 人 兴奋 的 是 ， 为 了 拥抱 Python 技术 生态 的 变化 ， 作 者 及 
时 增补 了 第 2 版 ， 奉 换 和 妃 加 了 很 多 常用 模块 /框架 /工具 的 介绍 ， 整 体 
上 更 贴近 实际 开发 环境 。 不 过 ， 从 大 妈 的 经 验 来 看 ， 完 全 无 基础 的 读者 
最 好 别 从 第 1 章 开 始 学 习 ， 人 否则 在 第 一 部 分 就 会 耗 尽 所 有 热情 。 


这 里 ， 我 建议 大 家 : 
。 第 一 部 分 尽 可 能 在 42 小 时 内 快速 浏览 一 过 ， 不 用 理解 ， 先 混 个 眼 
熟 ; 


第 二 部 分 跟着 项 目 实践 精读 ， 对 应 查阅 第 一 部 分 的 基础 知识 点 ， 针 
对 性 地 自我 答疑 ，。 


这 样 ， 你 就 能 从 枯燥 的 语法 、 控 制 结构 、 数 据 结构 等 无 穷 的 编程 概念 中 
挣脱 出 来 ， 进 入 一 个 个 具体 真实 的 项 目 场景 中 ， 一 切 将 变 得 卉 种 清晰 、 
有 目标 且 可 检验 。 当 然 ， 最 好 还 是 能 找到 一 起 学 习 的 小 伙伴 ， 无 论 是 线 
下 共 读 ， 还 是 线 上 远程 协同 。 总 之 ， 大 家 一 起 打 腾 ， 阅 读 和 学 习 才 可 能 
事半功倍 。 

最 后 ， 我 想 说 ，Python 是 否 值 得 学 ， 己 经 不 再 古 值得 怀疑 的 问题 了 特 
别 是 在 人 类 于 2018 年 用 Python 合成 首 张 黑洞 照片 之 后 )。 但 是 ， 如 何 
能 高 效 学 会 Python， 了 永远 是 个 值得 思考 的 重要 问题 。 


这 个 问题 的 答案 ， 是 绕 不 开本 书 的 。 


大 妈 /ZoomQuiet，CPyUG 联合 创始 人 、 虹 营 创始 人 


第 1 版 赞誉 


“No Starch Press 昔 故 易 新 ， 不 断 推 出 堪 与 传统 编程 图 书 比肩 的 未 来 经 
典 ， 而 本 书 就 是 其 中 之 一 。” 


Greg Laden，ScienceBlogs 
“对 复杂 的 项 目 九 娓 道 来 ， 届 和 辑 合 理 、 摧 心 避 目 ， 令 人 和 欲 娘 不 能 。” 
一 一 Full Circle 杂志 


“清晰 地 阐述 代码 片段 ， 引 领 你 每 次 前 进 一 小 步 ， 逐 步 编写 出 复杂 的 代 
码 ， 并 对 其 中 的 原理 了 如 指 掌 。” 


—— FlickThrough Reviews 
“美妙 的 Python 学 习 体 验 ，Python 新 手 的 不 二 选择 。” 
Mikke Goes Coding 


“名 副 其 实 ， 出 色 地 完成 了 引领 读者 从 入 门 到 实践 的 任务 。 三 个 项 目 既 
富有 挑战 性 又 离 教 于 乐 ， 还 有 大 量 极 具 帮助 的 练习 题 。” 


RealPython 网 站 


“人 简明 而 全 面 的 Python 编程 入 门 读物 ， 助 你 最 终 掌 握 Python， 是 一 本 值 
得 拥有 的 杰出 作品 。” 


一 一 TutorialEdge 网 站 


“编程 小 日 的 明智 之 选 。 化 票 为 和 测 ， 一 步 一 个 脚印 地 融 领 你 进入 Python 
这 门 深奥 语言 的 典 畦 。” 


一 WhatPixel 网 站 


“面面俱到 ， 初 学 者 需要 知道 的 Python 知识 应 有 尽 有 。” 


Firebear Studio GmbH 


说 以 此 书 献 给 我 的 父 杀 和 儿子 。 


感谢 父亲 抽出 时 间 来 回答 我 提出 的 每 个 编程 问题 ， 而 儿子 Ever 也 开始 
问 我 提问 了 。 


»/。 


采 言 


本 书 第 1 版 出 版 后 反 啊 强 烈 ， 被 翻译 成 了 8 种 语言 。 我 收 到 了 众多 读者 
的 来 信和 电子 邮件 ， 有 小 到 10 岁 的 孩童 ， 还 有 利用 用 暇 学 习 编 程 的 退 
休 人 员 。 有 一 些 初 中 、 蜗 中 和 大 学 用 其 作为 教材 ， 有 使 用 高 级 教材 的 学 
生 将 其 作为 补充 材料 ， 还 有 人 通过 阅读 它 来 提高 工作 技能 或 开发 目 己 的 
项 目 。 总 而 言 之 ， 第 1 版 的 广泛 用 途 完全 符合 我 最 初 的 预期 。 


第 2 版 的 编写 过 程 从 始 至 终 都 令 人 愉悦 。Python 虽 是 一 门 成 熟 的 语言 ， 
但 也 像 其 他 语言 一 样 在 不 断 发展 。 我 对 本 书 的 修订 目标 是 更 精练 、 更 简 
单 易 懂 。 现 在 已 经 没有 任何 理由 再 学 习 Python 2 了 ， 因 此 第 2 版 只 介绍 
Python 3。 很 多 Python 包 安 装 起 来 比 以 前 容易 ， 因 此 安装 说 明 也 更 加 简 
明 。 我 新 增 了 一 些 会 对 读者 有 帮助 的 主题 ， 更 新 了 部 分 章节 ， 以 反映 如 
何 利用 Python 中 的 新 方式 更 简单 地 完成 任务 ; 澄清 了 第 1 版 中 对 
Python 语言 的 某 些 细节 摘 述 得 不 太 准 确 的 地 方 。 所 有 项 目 都 做 了 全 面 修 
订 人 民 好 维护 的 流行 库 ， 让 你 能 够 充满 信心 地 用 它们 来 开发 自 
己 的 项 目 。 


下 面 概述 一 下 第 2 版 所 做 的 具体 修订 。 


第 1 章 简 化 了 Python 安装 流程 ， 适 用 于 所 有 主流 操作 系统 。 现 在 
我 推荐 使 用 文本 编辑 器 Sublime Text， 它 深 受 初学 者 和 专业 程序 员 
的 欢迎 ， 在 各 种 操作 系统 上 都 能 很 好 地 运行 。 

第 2 章 更 准确 地 描述 了 Python 变量 的 实现 方式 。 将 变量 描述 为 指 
向 值 的 标签 ， 让 读者 能 够 更 好 地 理解 Python 变量 的 行为 。 本 书 使 
用 Python 3.6 引入 的 f 字符 串 ， 该 方法 使 得 在 字符 串 中 使 用 变量 值 
简单 许多 。Python 3.6 还 引入 了 使 用 下 划 线 来 表示 大 数 的 方式 〈 如 
1 6868 666 ) 。 第 1 版 把 对 多 变量 赋值 的 介绍 放 在 一 个 项 目 中 ， 而 
第 2 版 则 将 其 推广 并 移 到 了 第 2 章 ， 旨 在 惠及 所 有 读者 。 最 后 ， 这 
一 章 介绍 了 Python 里 一 种 清晰 的 常量 表示 法 。 

第 6 章 新 增 了 介绍 方法 get() 的 内 容 。get() 从 字典 中 获取 值 ， 

并 在 指定 的 键 不 存在 时 返回 默认 值 。 

第 12 章 一 第 14 章 的 “外 星人 入 侵 ” 项 目 现在 完全 是 基于 类 的 。 游 戏 
本 身 也 是 类 ， 不 再 是 一 系列 函数 。 这 极 大 地 简化 了 游戏 的 总 体 结 
构 ， 大 大 地 减少 了 函数 调用 和 必须 提供 的 参数 。 阅 读 过 第 1 版 的 读 


者 一 定 会 对 这 样 的 简化 欣赏 有 加 。 对 于 所 有 操作 系统 ， 现 在 都 只 需 
一 个 命令 就 能 安装 Pygame。 此 外 ， 运 行 该 游戏 时 ， 可 在 全 屏 模式 
和 窗口 模式 之 间 选 择 。 

数据 可 视 化 项 目 中 的 Matplotlib 安装 方法 简化 了 ， 无 论 读者 使 用 的 
是 哪 种 操作 系统 。 使 用 Matplotlib 的 可 视 化 调用 的 是 函数 
subplots() ， 让 项 目 扩展 起 来 更 容易 。 

第 15 章 的 搓 仍 子 项 目 使 用 了 Plotty。 这 个 可 视 化 库 得 到 了 妥善 的 维 
护 ， 语 法 清晰 美观 ， 文 持 对 输出 进行 全 面 定 制 。 

第 16 章 的 天 气 项 目 使 用 了 来 自 美 国 国家 海洋 与 大 气管 理 局 的 数 


据 。 

第 17 章 不 再 使 用 Pygal 来 可 视 化 GitHub 的 Python 开源 项 目 ， 转 而 

使 用 Plotly。 

第 18 章 一 第 20 章 使 用 新 版 的 Django 创建 “学 习 笔 记 * 项 目 ， 并 使 

用 新 版 Bootstrap 设置 样式 。 使 用 django-heroku 简化 了 将 项 目 部 

署 到 Heroku 的 流程 ， 并 且 转 而 使 用 环境 变量 ， 而 非 修改 文件 

这 种 方法 更 简单 ， 更 接近 专业 程序 员 部 灵 Django 项 目 
J 

附录 A 做 了 全 面 修 订 ， 推 荐 读者 采用 最 佳 的 Python 安装 方法 。 附 

录 B 提供 了 详尽 的 Sublime Text 安装 说 明 ， 并 简要 介绍 了 大 部 分 主 

流 文本 编辑 器 和 IDE。 附 录 C 引导 读者 访问 更 新 、 更 流行 的 在 线 资 

源 以 寻求 帮助 。 附 录 D 提供 了 Git 版 本 控制 的 简明 教程 。 


感谢 购买 和 阅读 本 书 ! 如 果 有 任何 反馈 或 问题 ， 请 务必 与 我 联系 。 


致谢 


如 果 没 有 No Starch Press 出 色 专 业 人 士 的 帮助 ， 本 书 根 本 不 可 能 付 样 。 
是 Bill Pollock 邀请 我 编写 这 样 一 本 入 门 书 ， 深 深 感 谢 他 给 予 我 这 样 的 
机 会 。Tyler Ortman 在 我 编写 本 书 的 早期 帮助 我 理 清 了 思路 。Liz 
Chadwick 和 Leslie Shen 详细 阅读 了 每 一 章 ， 提 出 了 宝 贯 的 反馈 意见 ， 
而 Anne Marie Walker 助 我 把 本 书 的 很 多 内 容 写 得 更 加 清晰 。Riley 
了 漂亮 水 i 。 


这 里 要 感谢 技术 审阅 Kenneth Love。 我 与 Kenneth 相识 于 一 次 PyCon 年 
度 大 会 ， 他 对 Python 和 Python 社区 充满 热情 ， 一 直 是 我 获取 专业 有 灵感 
的 源 果 。Kenneth 不 仪 检查 了 本 书 介绍 的 知识 是 否 正确 ， 在 审阅 中 还 始 
终 抱 着 这 样 一 个 目的 : 让 编程 初学 者 对 Python 语言 和 编程 获得 扎实 的 认 
识 。 不 过 ， 倘 铬 本 书 有 任何 不 准确 的 地 方 ， 责 任 完全 在 我 。 


感谢 我 的 父 杀 在 我 很 小 的 时 候 束 教 我 编程 ， 一 点 儿 也 不 担心 我 破坏 他 的 
设备 。 感 谢 妻子 Erin 在 我 编写 本 书 期 间 一 如 既往 的 或 励 和 文 持 。 还 要 
感谢 儿子 Ever， 他 的 好 奇 心 每 天 都 会 给 我 带 来 灵感 。 


E 印 十 
本 以 


如 何 学 习 编写 第 一 个 程序 ， 每 个 程序 员 都 有 不 同 的 故事 。 我 还 是 个 孩子 
时 就 开始 学 习 编程 了 ， 当 时 我 父亲 在 计算 时 代 的 先锋 之 一 一 一 数字 设备 
公司 (Digital Equipment Corporation ) 工作 。 我 使 用 一 台 简 陋 的 计算 机 
编写 了 第 一 个 程序 ， 这 人 台 计 算 机 是 父 杀 在 家 里 的 地 下 室 组 闭 而 成 的 ， 它 
没有 机 箱 ， 裸 露 的 主板 与 键盘 相连 ， 显 示 器 是 裸露 的 阴极 射线 管 。 我 编 
写 的 这 个 程序 是 一 球 简 单 的 猜 数 字 游 戏 ， 其 输出 类 似 于 下 面 这 样 : 


I'm thinking of a number! Try to guess the number I'm thinking of: 25 
Too low! Guess again: 56 
Too high! Guess again: 42 


That 's it! Would you like to play again? (yes/no) no 
Thanks for playing! 


看 到 家 人 玩 着 我 编写 的 游戏 ， 而 且 它 完全 按 我 预期 的 方式 运行 ， 我 心里 
不 知 有 多 满足 。 此 情 此 景 我 永远 都 乐 不 了 。 
儿童 时 期 的 这 种 体验 一 直 影 响 我 至 今 。 现 在 ， 每 当 我 通过 编写 程序 解决 


了 一 个 问题 时 ， 心 里 都 会 感到 非常 满足 。 相 比 于 孩提 时 期 ， 我 现在 编写 
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读者 对 象 


本 书 旨 在 让 你 尽快 学 会 Python， 以 便 能 够 编写 能 正确 运行 的 程序 游 
戏 、 数 据 可 视 化 和 Web 应 用 程序 ， 同 时 掌握 让 你 终 映 受益 的 基本 编程 
知识 。 本 书 适合 任何 年 龄 的 读者 阅读 ， 它 不 要 求 你 有 Python 编程 经 

验 ， 甚 至 不 要 求 你 有 编程 经 验 。 如 果 你 想 快 速 掌握 基本 的 编程 知识 以 便 
专注 于 开发 感 兴趣 的 项 目 ， 并 想 通 过 解决 有 意义 的 问题 来 检查 你 对 新 学 
概念 的 理解 程度 ， 那 么 本 书 束 是 为 你 编写 的 。 本 书 可 供 初 中 和 高 中 教师 
用 来 通过 开发 项 目 同 学 生 介 绍 编程 。 如 果 你 是 刚 开始 学 习 Python 的 大 
ee 的 教材 不 那么 容易 理解 ， 那 么 阅读 本 书 将 让 学 习 过 程 

企 松 。 


本 书 内 容 


本 书 定 在 让 你 成 为 优 夯 的 程序 员 ， 具 体 地 说 ， 是 优秀 的 Python 程序 
员 。 通 过 阅读 本 书 ， 你 将 迅速 掌握 编程 概念 ， 打 下 坚实 的 基础 ， 并 养 成 
民 好 的 习惯 。 阅 读本 书后 ， 你 束 可 以 开始 学 习 Python 高 级 技术 ， 并 能 
够 更 轻松 地 掌握 其 他 编程 语言 。 


在 本 书 的 第 一 部 分 ， 你 将 学 习 编 写 Python 程序 时 需要 熟悉 的 基本 编程 
概念 ， 你 刚 接触 几乎 任何 编程 语言 时 都 需要 学 习 这 些 概 念 。 你 将 学 习 各 
种 数据 以 及 在 程序 中 将 数据 存储 到 列表 和 字典 中 的 方式 。 你 将 学 习 如 何 
创建 数据 集 以 及 如 何 高 效 地 遍历 它们 。 你 将 学 习 使 用 while 和 if 语句 
来 检查 条 件 ， 并 在 条 件 满 足 时 执行 代码 的 一 部 分 ， 而 在 条 件 不 满足 时 执 
行 代码 的 另 一 部 分 一 一 这 可 为 自动 完成 处 理 提供 极 大 的 帮助 。 


你 将 学 习 获取 用 户 输入 ， 让 程序 能 够 与 用 户 交 互 ， 并 在 用 户 没 停止 输入 
时 保持 运行 状态 。 你 将 探索 如 何 编写 函数 来 让 程序 的 各 个 部 分 可 重用 ， 

这 样 你 编写 执行 特定 任务 的 代码 后 ， 想 使 用 它 多 少 次 都 可 以 。 然 后 ， 你 
将 学 习 使 用 类 来 扩展 这 种 概念 以 实现 更 复杂 的 行为 ， 从 而 让 非常 简单 的 
程序 也 能 处 理 各 种 不 同 的 情形 。 你 将 学 习 编 写 受 善 处 理 常 见 错误 的 程 

序 。 学 习 这 些 基 本 概念 后 ， 你 束 能 编写 一 些 简 短 的 程序 来 解决 一 些 明确 
的 问题 。 最 后 ， 你 将 向 中 级 编程 迈 出 第 一 步 ， 学 习 如 何 为 代码 编写 测 

试 ， 以 便 在 进一步 改进 程序 时 不 用 担心 可 能 引入 bug。 第 一 部 分 介绍 的 
知识 让 你 能 够 开发 更 大 、 更 复杂 的 项 目 。 


在 第 二 部 分 ， 你 将 利用 在 第 一 部 分 学 到 的 知识 来 开发 三 个 项 目 。 你 可 以 
根据 目 己 的 情况 ， 以 最 合适 的 顺序 完成 这 些 项 目 ， 你 也 可 以 选择 只 完成 
其 中 的 茶 些 项 目 。 在 第 一 个 项 目 〈 第 12 章 一 第 14 章 ) 中 ， 你 将 创建 一 
个 类 似 于 《太空 入 侵 者 》 的 射击 游戏 ， 这 个 游戏 名 为 《外 星人 入 侵 》， 
它 包 含 多 个 难度 不 断 增 加 的 等 级 。 完 成 这 个 项 目 后 ， 你 就 完全 能 够 自己 
动手 开发 2D 游戏 了 。 


第 二 个 项 目 (第 15 章 一 第 17 章 ) 介绍 数据 可 视 化 。 数 据 科 学 家 的 目标 
古 通 过 各 种 可 视 化 技术 来 搞 展 海量 信息 。 你 将 使 用 通过 代码 生成 的 数据 
集 、 已 经 从 网 络 下 载 下 来 的 数据 集 以 及 程序 上 自动 下 载 的 数据 集 。 完 成 这 
个 项 目 后 ， 你 将 能 够 编写 能 对 大 型 数据 集 进 行 得 选 的 程序 ， 并 以 可 视 化 
方式 将 和 中选 出 来 的 数据 呈现 出 来 。 


在 第 三 个 项 目 (第 18 章 一 第 20 章 ) 中 ， 你 将 创建 一 个 名 为 “学 习 笔 

记 ” 的 小 型 Web 应 用 程序 。 这 个 项 目 能 够 让 用 户 将 学 到 的 与 特定 主题 相 
关 的 概念 记录 下 来 。 你 将 能 够 分 别 记录 不 同 的 主题 ， 还 可 以 让 其 他 人 建 
立 账 户 并 开始 记录 自己 的 学 习 笔记 。 你 还 将 学 习 如 何 部 署 这 个 项 目 ， 让 
任何 人 都 能 够 通过 网 络 访问 它 ， 而 不 管 他 号 处 何方 。 


在 线 资 源 
要 获取 以 下 补充 材料 ， 可 访问 https:/www.ituring.com.cn/book/2784 。 


安装 说 明 : 与 书 中 的 安装 说 明 相 同 ， 但 可 直接 点 击 其 中 的 链接 ， 
无 须 动手 输入 。 过 到 安装 问题 时 ， 可 参阅 这 些 材料 。 

更 新 : 与 其 他 编程 语言 一 样 ，Python 也 是 在 不 断 发 展 变化 的 。 我 
提供 了 详尽 的 更 新 记录 ， 每 当 遇 到 问题 时 ， 你 都 可 参阅 它 看 看 是 人 否 
需要 调整 操作 。 

练习 答案 : 你 应 该 伦 大 量 时 间 独 立 完成 “动手 试 一 试 ?中 的 练习 ， 
但 如 果 卡 之 了 、 无 法 取得 进展 ， 可 在 线 查 看 部 分 练习 的 答案 。 
0 在 线 提供 了 完整 的 速 得 表 ， 可 作为 主要 概念 的 参考 指 
南 。 


为 何 使 用 Python 


继续 使 用 Python， 还 是 转 而 使 用 其 他 语言 一 一 也 许 是 编程 领域 较 新 的 语 
言 ? 我 每 年 都 会 考虑 这 个 问题 。 可 我 依然 专注 于 Python， 其 中 的 原因 很 
多 。Python 是 一 种 效率 极 高 的 语言 : 相 比 于 众多 其 他 的 语言 ， 使 用 
Python 编写 时 ， 程 序 包含 的 代码 行 更 少 。Python 的 语法 也 有 助 于 创建 整 
洁 的 代码 : 相 比 于 使 用 其 他 语言 ， 使 用 Python 编写 的 代 人 码 更 容易 阅 
读 、 调 试 和 扩展 。 


大 家 将 Python 用 于 众多 方面 : 编写 游戏 、 创 建 Web 应 用 程序 、 解 决 商 
业 问 题 以 及 供 各 类 有 趣 的 公司 开发 内 部 工具 。Python 还 在 科学 领域 被 大 
量 用 于 学 术 研究 和 应 用 研究。 


我 依然 使 用 Python 的 一 个 最 重要 的 原因 是 ，Python 社区 有 形形色色 充 
满 激情 的 人 。 对 程序 员 来 说 ， 社 区 非常 重要 ， 因 为 编程 绝 非 孤独 的 修 
行 。 大 多 数 程 序 员 都 需要 问 解 决 过 类 似 问 题 的 人 寻求 建议 ， 经 验 最 为 丰 
定 的 程序 员 也 不 例外 。 需 要 有 人 帮助 解决 问题 时 ， 有 一 个 联系 紧密 、 互 
帮 互 助 的 社区 至 关 重 要 ， 而 对 于 像 你 一 样 将 Python 作为 第 一 门 语言 来 
学 习 的 人 而 言 ，Python 社区 无 疑 是 坚强 的 后 盾 。 


Python 是 一 门 出 色 的 语言 ， 值 得 你 去 学 习 。 现 在 就 开始 吧 ! 


电子 书 
扫描 如 下 二 维 码 ， 即 可 购买 本 书 电子 版 。 


第 一 部 分 “基础 知识 


本 书 的 第 一 部 分 介绍 编写 Python 程 序 所 需要 熟悉 的 基本 概念 ， 其 中 很 多 
适用 于 所 有 编程 语言 ， 因 此 它们 在 你 的 整个 程序 员 生 涯 中 都 很 有 用 。 


第 1 章 介 绍 在 计算 机 中 安装 Python， 并 运行 第 一 个 程序 一 一 在 屏幕 上 打 
印 “Hello Python world!”。 


第 2 章 论述 如 何在 变量 中 存储 信息 以 及 如 何 使 用 文本 和 数字 。 


第 3 音 和 第 4 章 介 绍 列表 。 使 用 列表 能 够 在 一 个 变量 中 存储 任意 数量 的 信 
恩 ， 从 而 高 效 地 处 理 数据 : 只 需 几 行 代码 ， 你 就 能 够 处 理 数 百 、 数 干 力 
至 数 百 万 个 值 。 


第 5 章 讲 解 使 用 if 语句 来 编写 这 样 的 代码 : 在 特定 条 件 满足 时 采取 一 种 
普 施 ， 而 在 该 条 件 不 满足 时 采取 妨 一 种 措施 。 


第 6 章 演 示 如 何 使 用 Python 字典 ， 将 不 同 的 信息 关联 起 来 。 与 列表 一 
样 ， 你 也 可 以 根据 需要 在 字典 中 存储 任意 数量 的 信息 。 


第 7 章 讲 解 如 何 从 用 户 那 里 获取 输入 ， 让 程序 变 成 交互 式 的 。 你 还 将 学 
习 while 循环 ， 它 不 断 地 运行 代码 块 ， 直 到 指定 的 条 件 不 再 满足 为 止 。 


第 8 半 介 绍 编写 函数 。 函 数 是 执行 特定 任务 的 被 命名 的 代码 块 ， 你 可 以 
根据 需要 随时 运行 它 。 


第 9 章 介 绍 类 ， 它 让 你 能 够 模拟 实物 ， 如 小 狗 、 小 猫 、 人 、 汽 车 、 火 箭 
等 ， 让 你 的 代码 能 够 表示 任何 真实 或 抽象 的 东西 。 


第 10 章 介绍 如 何 使 用 文件 ， 以 及 如 何 处 理 错误 以 免 程 序 意 外 地 衣 溪 。 你 
需要 在 程序 关闭 前 保存 数据 ， 并 在 程序 再 次 运行 时 读 取 它 们 。 你 将 学 习 
Python 有 异常， 它们 让 你 能 够 未 雨 绸 纱 ， 从 而 让 程序 受 善 地 处 理 错 误 。 


第 11 章 讲解 为 代码 编写 测试 ， 以 核实 程序 是 人 否 像 你 期 望 的 那样 工作 。 这 


样 ， 扩 展 程 序 时 ， 你 束 不 用 担心 引入 新 的 bug 了 。 要 想 脱 离 初级 程序 员 
的 阵容 ， 跻 身 于 中 级 程序 员 的 行列 ， 测 试 代码 是 你 必须 和 擎 握 的 基本 抠 能 


B22 在 本 章 中 ， 你 将 运行 自己 的 第 一 个 程序 
hello_world.py。 为 此 ， 你 首先 需要 检查 自己 的 计算 机 是 否 安 装 了 较 
新 版 本 的 Python; 如 果 没 有 ， 残 要 安装 它 。 你 还 要 安装 一 个 文本 编 
辑 器 ， 用 于 编写 和 运行 Python 程序 。 你 输入 Python 代码 时 ， 这 个 文 
本 编辑 器 能 够 识别 它们 并 突出 显示 不 同 的 部 分 ， 让 你 能 够 轻松 地 了 
解 代 码 的 结构 。 


1.1 搭建 编程 环境 


在 不 同 的 操作 系统 中 ，Python 存 在 细微 的 差别 ， 因 此 有 几 点 你 需要 牢记 
在 心 。 本 节 将 确保 你 的 系统 正确 安装 Python 


1.1.1 Python 上 挨 本 


每 种 编程 语言 都 会 随 着 新 概念 和 新 技术 的 推出 而 不 断 发 展 ，Python 开 发 
者 也 在 一 直 致 力 于 丰富 和 强化 其 功能 。 本 书 编 写 期 间 的 最 新 版 本 为 
Python 3.7， 但 只 要 你 安装 了 Python 3.6 或 更 高 的 版 本 ， 就 能 运行 本 书 中 
的 所 有 代码 。 在 本 节 中 ， 你 将 核实 系统 是 个 安装 了 Python， 以 及 是 否 需 
要 安装 更 新 的 版 本 。 附 录 人 A 提供 了 详尽 的 指南 ， 指 导 你 在 各 种 主流 操作 
系统 中 安装 最 新 版 本 的 Python。 


有 些 较 老 的 Python 项 目 依然 使 用 Python 2， 但 你 应 该 使 用 Python 3。 如 果 
你 的 系统 安装 了 Python 2， 很 可 能 是 为 了 支持 系统 需要 的 一 些 旧 程序 。 
你 应 保留 它 ， 并 安装 更 新 的 版 本 以 便 学 习 本 书 。 


1.1.2 运行 Python 代 码 片段 


Python 自 带 一 个 在 终端 窗口 中 运行 的 解释 器 ， 让 你 无 须 保 存 并 运行 整个 
程序 就 能 尝试 运行 Python 代 人 码 片 段 。 


本 书 将 以 如 下 方式 列 出 代码 片段 : 


@ >>> print("Hello Python interpreter!") 
Hello Python interpreter! 


提示 符 >>> 表明 正在 使 用 终端 窗口 ， 而 加 粗 的 文本 表示 需要 你 输入 之 后 
按 回 车 键 来 执行 的 代码 。 本 书 的 大 多 数 示例 是 独立 的 小 程序 ， 你 将 在 编 
辑 右 中 执行 它们 ， 因 为 大 多 数 代码 也 是 这 样 编写 出 来 的 。 然 而 ， 为 高 效 
地 演示 一 些 基本 概念 ， 需 要 在 Python 终 端 会 话 中 执行 一 系列 代码 片段 。 
只 要 代码 清单 中 包含 三 个 右 尖 括号 (如 人 @ 所 示 ) ， 就 意味 着 代码 是 在 终 
端 会 话 中 执行 的 ， 而 输出 也 是 来 目 终端 会 话 的 。 稍 后 将 演示 如 何在 


Python 解释 器 中 编写 代码 。 


此 外 ， 你 还 要 安装 一 牧 文 本 编辑 器 ， 并 使 用 它 来 完成 学 习 编 程 的 标准 操 
作 一 一 编写 一 个 简单 的 Hello World 程 序 。 长 期 以 来 ， 编 程 界 都 认为 刚 接 
触 一 门 新 语言 时 ， 如 果 首 移 使 用 它 来 编写 一 个 在 屏幕 上 显示 消息 "Hello 
world!” 的 程序 ， 将 给 你 带 来 好 运 。 这 种 程序 虽然 镜 单 ， 却 有 其 用 途 : 如 
0 
正确 运行 。 


1.1.3 Sublime Text 简 介 


Sublime Text 是 一 球 简 单 的 文本 编辑 器 ， 可 以 在 任何 现代 操作 系统 中 安 
装 。 你 几乎 能 直接 在 Sublime Text 中 执行 所 有 程序 。 在 Sublime Text 中 执 
行程 序 时 ， 人 代码 将 在 其 内 舱 的 终端 会 话 中 和 运行， 让 你 能 够 轻松 地 看 到 输 
Hz 


Sublime Text 是 一 于 适合 初学 者 的 编辑 器 ， 但 很 多 专业 编程 人 员 也 在 使 
用 它 。 在 学 习 Python 的 过 程 中 熟练 掌握 Sublime Text 之 后 ， 可 继续 使 用 
它 来 编写 复杂 的 大 型 项 目 。Sublime Text 的 许可 条 件 非 常 宽松 ， 可 以 一 
直 免 费 使 用 ， 但 如 果 你 喜欢 它 并 想 长 期 使 用 ， 其 开发 者 会 要 求 你 购买 放 
可 证 。 


附录 B 介 绍 了 其 他 几 种 文本 编辑 嚣 ， 如 果 你 想 知 道 还 有 哪些 编辑 器 可 供 
使 用 ， 现 在 就 应 该 读 一 读 。 如 采 你 想 马 上 动手 编程 ， 可 先 使 用 Sublime 
Text， 等 有 了 一 些 编程 经 验 后 绸 考虑 使 用 其 他 编辑 器 。 本 草 稍 后 将 引导 
你 在 当前 使 用 的 操作 系统 中 安装 Sublime Text。 


1.2 ”在 不 同 操作 系统 中 搭建 Python 编程 环境 


Python 是 一 种 路 平台 的 编程 语言 ， 这 意味 着 它 能 够 运行 在 所 有 主流 操作 
系统 中 。 在 所 有 安装 了 Python 的 现代 计算 机 上 ， 都 能 够 运行 你 编写 的 任 
然而 ， 在 不 同 的 操作 系统 中 ， 安 装 Python 的 方法 存在 细 
微 的 差别 。 


在 本 节 中 ， 你 将 学 习 如 何在 上 自己 的 系统 中 安 闭 Python。 首 先 要 检查 系统 
是 否 安装 了 较 新 的 Python 版 本 ， 如 果 没 有 ， 就 进行 安装 ;然后 是 安装 

Sublime Text。 在 不 同 的 操作 系统 中 搭建 Python 编程 环境 时 ， 只 有 这 两 
步 存 在 差别 。 


接 下 来 ， 你 将 运行 Hello World 程 序 ， 并 排除 各 种 故障 。 我 将 详细 介绍 如 
何在 各 种 操作 系统 中 完成 这 些 任 务 ， 让 你 能 够 搭建 一 个 对 初学 者 友好 的 
Python 编程 环境 。 


1.2.1 在 Windows 系 统 中 搭建 Python 编 程 环境 


Windows 系 统 并 非 都 默认 安装 了 Python， 因 此 你 可 能 需要 安装 它 ， 再 安 
装 Sublime Text。 


01. 安装 Python 


首先 ， 检 查 你 的 系统 是 否 安装 了 Python。 为 此 ， 在 “开始 ” 荣 单 中 输 
入 command 并 按 回 车 以 打开 一 个 命令 窗口 ;也 可 以 按 住 Shift 键 并 右 
击 桌 面 ， 选 择 “ 在 此 处 打开 命令 窗口 ”* 。 在 终端 窗口 中 输入 python 
(全 部 小 写 ) 并 按 回 车 : 如 果 出 现 了 Python 提 示 符 (>>> ) ， 吏 说 
明 系 统 安 装 了 Python; 如 果 出 现 一 条 错误 消息 ， 指 出 python 是 无 
法 识别 的 命令 ， 就 说 明 没 有 安装 Python。 


如 果 出 现 后 一 种 情况 或 者 安装 的 Python 版 本 低 于 3.6， 束 需要 下 载 
Windows Python 安装 程序 。 为 此 ， 请 访问 Python 官方 网 站 主页 。 将 
鼠标 指 癌 Download 链 接 ， 你 将 看 到 一 个 用 于 下 载 最 新 版 本 Python 的 
按钮 。 单 击 访 按钮， 这 将 根据 你 的 系统 自动 下 载 正 确 的 安装 程序 。 
下 载 安装 程序 后 ， 运 行 它 。 请 务必 选中 复 选 框 Add Python〈 版 本 
号 ) to PATH (例如 图 1-1) ， 这 让 你 能 够 更 轻松 地 配置 系统 。 


tp python 3.7.2 (64-bib Setup 一 x 


Install Python 3.7.2 (64-bit) 


Select Install Now to install Python with default settings, or choose 
Customize to enable or disable features. 


一 Install Now 
CGC:\Users\matthese\AppData\LocalN\Programs\Python\Python37 
Includes IDLE, pip and documentation 
Creates shortcuts and file associations 


一 Customize installation 
Choose location and features 


python 


for 口 Install launcher for all users (recommended) 


windows BAdd Python 3.7 to PATH | Cancel | 


图 1-1 确保 选中 复 选 框 Add Python (版 本 号 ) to PATH 


02. 在 终端 会 话 中 运行 Python 


打开 一 个 命令 窗口 ， 并 在 其 中 执行 命令 python 。 如 果 出 现 了 
Python 提 示 符 (>>> ) ， 就 说 明 Windows 找 到 了 你 由 | 安装 的 Python 
版 本 。 


C:\> python 
Python 3.7.2 (v3.7.2:9a3ffc8492, Dec 23 2018，23:69:28) [MSC v.1916 64 
(AMD64)] on win32 


Type "help", "copyright", "credits" or "license" for more information. 
>>> 


注意 ”如 果 没 有 看 到 类 似 的 输出 ， 请 参阅 附录 A 中 更 详尽 的 安 
装 说 明 。 


在 Python 会 话 中 执行 下 面 的 命令 ， 并 确认 看 到 了 输出 “Hello Python 


interpreter!”。 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 
>>> 


| 


每 当 要 运行 Python 代 码 片段 时 ， 都 请 打开 一 个 命令 窗口 并 启动 
Python 终 问 会 话 。 要 关闭 该 终端 会 话 ， 可 按 Ctrl + Z2、 再 按 回 车 键 ， 
也 可 执行 命令 exit() 。 


03. 安装 Sublime Text 
要 下 载 Sublime Text 安 装 程 序 ， 可 访问 Sublime Text 网 站 主页 ， 单 击 


Download 链 接 ， 并 查找 Windows 安 装 程序 。 下 载 安装 程序 后 运行 
它 ， 并 接受 所 有 的 默认 设置 。 


1 在 Windows 10 系 统 中 ， 可 如 此 打开 PowerShell 窗 口 。 编者 注 


1.2.2 ”在 macOS 系 统 中 搭建 Python 编程 环境 


大 多 数 macOS 系 统 默认 安装 了 Python。 确 定安 装 了 Python 后 ， 你 还 需 安 
装 Sublime Text， 并 确保 其 配置 正确 无 误 。 


01. 检查 是 否 安装 了 了 Python 3 


在 文件 夹 Applications/Utilities 中 ， 选 择 Terminal， 打 开 一 个 终端 窗 

口 ; 也 可 以 按 Command + 空格 键 ， 再 输入 terminal 并 按 回 车 。 为 
确定 是 否 安 装 了 Python， 请 执行 命令 python (请 注意 ， 其 中 的 p 是 
小 写 的 ) ， 这 也 将 在 终端 窗口 中 启动 Python， 让 你 能 够 输入 Python 
命令 。 输 出 类 似 于 下 面 这样 ， 它 指出 了 安装 的 Python 版 本 ; 最 后 的 


>>> 是 提示 符 ， 让 你 能 够 输入 Python 命令 。 


$ python 
Python 2.7.15 (default, Aug 17 2618，22:39:65) 
[GCC 4.2.1 Compatible Apple LLVM 9.1.6 (clang-962.0.39.2)] on darwin 


Type "help", "copyright", "credits", or "license" for more information 
>>> 


上 述 输 出 表明 ， 妆 前 计算 机 默认 使 用 的 Python 版 本 为 Python 


02. 


03. 


2.7.15。 看 到 上 述 输出 后 ， 如 果 要 退出 Python 并 返回 到 终端 窗口 ， 
可 按 Ctrl + D 或 执行 命令 exit() 。 


要 检查 系统 是 否 安装 了 Python 3， 可 尝试 执行 命令 python3 。 可 能 
会 出 现 一 条 错误 消息 ， 这 意味 肴 没有 安 闭 任何 Python 3 版 本 。 如 果 
输出 指出 安装 了 Python 3.6 或 更 高 的 版 本 ， 可 以 直接 跳 过 下 一 小 
闻 。 如 果 系 统 没有 安 六 Python 3， 就 需要 手动 安装 它 。 注 意 ， 请 将 
本 书 中 所 有 的 命令 python 都 蔡 换 为 命令 python3 ， 这 样 才能 使 用 
Python 3《〈 而 不 是 Python 2) 。Python 2 和 Python 3 的 卉 别 非常 大 ， 
如 条 你 使 用 Python 2 来 运行 本 书 的 代码 ， 上 痛 定 会 遇 到 朵 烦 。 


如 果 系 统 默认 安装 的 是 低 于 Python 3.6 的 版 本 ， 请 按 下 一 小 节 的 说 
明 安 闭 最 新 版 本 。 


安装 最 新 的 Python 版 本 


要 下 载 Python 安 装 程序 ， 可 访问 Python 网 站 主页 。 将 鼠标 指 辐 
Download 链 接 ， 你 将 看 到 一 个 用 于 下 载 最 新 版 本 Python 的 按钮 。 单 
击 该 按钮 ， 这 将 根据 你 的 系统 自动 下 载 正确 的 安装 程序 。 下 载 安 装 
程序 后 ， 运 行 它 。 


运行 安装 程序 后 ， 在 终端 提示 符 下 执行 如 下 命令 : 


$ python3 --version 
Python 3.7.2 


输出 应 该 类 似 于 上 面 这 样 。 如 果 确 实 如 此 ， 束 可 以 开始 疾 试 使 用 
Python 了 ， 但 请 务必 将 本 书 中 的 每 个 命令 python 都 蕉 换 
为 python3 。 


在 终端 会 话 中 运行 Python 代码 


现在 可 以 打开 终端 窗口 并 执行 命令 python3 ， 再 尝试 运行 Python 代 
码 片 段 。 请 在 终端 会 话 中 输入 如 下 代码 行 并 按 回 车 : 


04. 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 


>>> 


消息 将 直接 输出 到 当前 终端 窗口 中 。 别 忘 了 ， 要 关闭 Python 解 释 
器 ， 可 按 Ctrl + D 或 执行 命令 exit() 。 


安装 Sublime Text 


要 安装 编辑 器 Sublime Text， 需 要 下 载 安装 程序 。 为 此 ， 可 访问 
Sublime Text 网 站 主页 ， 单 击 链 接 Download， 并 查找 macOS 安 装 程 
序 。 下 载 安 装 程 序 后 运行 它 ， 再 将 Sublime Text 图 标 拖 放 到 文件 夹 
Applications 中 。 


1.2.3 在 Linux 系 统 中 搭建 Python 编程 环境 


Linux 系 统 是 为 编程 而 设计 的 ， 因 此 大 多 数 Linux 计 算 机 默认 安装 了 
Python。 编 号 和 维护 Linux 的 人 认为 ， 你 很 可 能 会 使 用 这 种 系统 进行 编 
程 ， 他 们 也 鼓励 你 这 样 做 。 因 此 ， 要 在 这 种 系统 中 编程 ， 你 几乎 不 用 安 
装 什 么 软件 ， 只 需要 修改 一 些 设置 。 


01. 检查 Python 版 本 


在 你 的 系统 中 运行 应 用 程序 Terminal (如 果 你 使 用 的 是 Ubuntu， 可 
按 Ctrl + Alt+T) ， 打 开 一 个 终端 窗口 。 为 确定 安装 的 是 哪个 
Python 版 本 ， 请 执行 命令 python3 (请 注意 ， 其 中 的 p 是 小 写 
的 ) 。 如 果 安 装 了 Python， 这 个 命令 将 局 动 Python 解释 堪 。 输 出 类 
似 于 下 面 这 样 ， 它 指出 了 安装 的 Python 版 本 ; 最 后 的 >>> 是 提示 
符 ， 让 你 能 够 输入 Python 命令 。 


$ python3 

Python 3.7.2 (default, Dec 27 2618，64:61:51) 

[GCC 7.3.6] on linux 

Type "help", "copyright", "credits" or "license" for more information . 
>>> 


02. 


03. 


上 述 输出 表明 ， 当 前 计算 机 默认 使 用 的 Python 版 本 为 Python 3.7.2。 
看 到 上 述 输出 后 ， 如 果 要 退出 Python 并 返回 到 终端 窗口 ， 可 按 Ctrl + 
DD 或 执行 命令 exit() 。 务 必 将 本 书 中 的 每 个 命令 python 都 蔡 换 
为 python3 。 

要 运行 本 书 的 代码 ， 必 须 使 用 Python 3.6 或 更 高 的 版 本 。 如 果 系 统 
3.6 的 版 本 ， 请 参阅 附录 A， 了 解 如 何 安装 最 新 


在 终端 会 话 中 运行 Python 代码 
现在 可 打开 终端 窗口 并 执行 命令 python3 ， 再 尝试 运行 Python 代 人 码 


片段 。 检 查 Python 版 本 时 ， 你 残 这 样 做 过 。 下 面 再 次 这 样 做 ， 然 后 
在 终端 会 话 中 输入 如 下 代码 并 按 回 车 : 


>>> print("Hello Python interpreter!") 
Hello Python interpreter! 


>>> 


消息 将 直接 打印 到 当前 终端 窗口 中 。 别 忘 了 ， 要 关闭 Python 解 释 
器 ， 可 按 Ctrl + D 或 执行 命令 exit() 。 


安装 Sublime Text 


在 Linux 系 统 中 ， 可 通过 Ubuntu Software Center 来 安装 Sublime 
Text。 为 此 ， 单 击 菜单 中 的 Ubuntu Software 图 标 并 查找 Sublime 
Text， 再 通过 单 击 来 安装 它 。 


1.3 运行 Hello World 程 序 


安装 较 新 版 本 的 Python 和 Sublime Text 后 ， 就 可 以 编写 并 运行 你 的 第 一 
个 Python 程序 了 。 这 样 做 之 前 ， 需 要 设置 Sublime Text， 确 保 它 使 用 系 
统 中 正确 的 Python 版 本 。 然 后 ， 束 可 以 编写 并 运行 Hello World 程 序 了 。 


1.3.1 配置 Sublime Text 以 使 用 正确 的 Python 版 本 


如 果 在 你 的 系统 中 执行 命令 python 时 启动 的 是 Python 3， 就 无 须 做 任何 
配置 ， 直 接 跳 到 下 一 节 即 可 。 如 果 需 要 执行 命令 python3 来 启动 
Python， 就 需要 配置 Sublime Text， 使 其 使 用 正确 的 Python 版 本 来 运行 你 
编写 的 程序 。 


为 此 ， 单 击 Sublime Text 图 标 以 局 动 它 ， 也 可 在 搜索 栏 中 输入 Sublime 
Text 来 找到 它 再 司 动 。 选 择 菜 单 Tools w Build System * New Build 
System， 新 建 一 个 配置 文件 。 删 除 该 文件 中 的 所 有 内 容 ， 再 输入 如 下 内 


AAAN 


合 : 
Python3 


.Sublime-build 


": ["python3", "-u", "$file"], 


这 段 代码 让 Sublime Text 使 用 命令 python3 来 运行 Python 程序 。 将 这 个 
文件 保存 到 Sublime Text 默 认 打 开 的 文件 夹 中 ， 并 将 其 命名 为 
python3.sublime-build。 


1.3.2 ”运行 程序 hello_world.py 


编写 第 一 个 程序 前 ， 在 系统 中 创建 一 个 名 为 python_work 的 文件 来， 用 
于 存储 你 开发 的 项 目 。 文 件 名 和 文件 夹 名 称 最 好 使 用 小 写字 母 ， 并 使 用 
下 划 线 代 蔡 空格 ， 因 为 Python 采用 了 这 些 命名 约定 。 


启动 Sublime Text， 再 选择 菜单 File w Save As 将 Sublime Text 创 建 的 空 文 
件 存 储 到 文件 夹 python_work 中 ， 并 将 其 命名 为 hello_world.py。 文 件 扩 
展 名 .py 告诉 Sublime Text， 文 件 中 的 代码 是 使 用 Python 编写 的 ， 这 能 让 
它 知道 如 何 运行 这 个 程序 ， 并 以 有 帮助 的 方式 突出 其 中 的 代码 。 


保存 这 个 文件 后 ， 在 其 中 输入 如 下 代码 行 : 


hello_world.py 


print("Hello Python world!") 


在 你 的 系统 中 ， 如 果 能 使 用 命令 python 来 启动 Python 3， 可 以 选择 菜单 
Tools w Build 或 按 Ctrl + B〈 在 macOS 系 统 中 为 Command + B) 来 运行 程 
序 。 如 果 需 要 像 前 一 节 那 样 配置 Sublime Text， 请 选择 订单 Tools w Build 
System > Python 3 来 运行 这 个 程序 。 从 此 以 后 ， 你 就 可 以 选择 肖 单 Tools 
> Build 或 按 Ctrl + B (或 Command + B) 来 运行 程序 了 。 


在 Sublime Text 的 底部 ， 将 出 现 一 个 终端 窗口 ， 其 中 包含 如 下 输出 : 


Hello Python world! 
[Finished in 6.1s] 


如 果 看 不 到 上 述 输出 ， 可 能 是 因为 这 个 程序 出 了 点 问题 。 请 检查 你 输入 
的 每 个 字符 。 是 否 不 小 心 将 print 的 首 字 母 大 写 了 ? 是 否 遗 漏 了 引号 或 
圆 括 号 ? 编程 语言 的 语法 非常 严格 ， 只 要 不 满足 要 求 ， 就 会 报错 。 如 宁 
你 无 法 运行 这 个 程序 ， 请 参阅 下 一 节 的 建议 。 


1.4 解决 安装 问题 


如 果 无 法 运行 程序 hello_world.py， 可 尝试 如 下 几 个 解决 方法 ， 这 些 通 用 
方法 适用 于 所 有 编程 问题 。 


。 程序 存在 严重 错误 时 ，Python 将 显示 traceback， 即 错误 报告 。 
Python 会 仔细 研究 文件 ， 试 图 找 出 其 中 的 问题 。trackback 可 能 会 提 
供 线索 ， 让 你 知道 是 什么 问题 让 程序 无 法 运行 。 

离开 计算 机 ， 先 休息 一 会 儿 再 答 试 。 别 筷 了 ， 语 法 在 编程 中 非常 重 
要 ， 即 便 是 少 一 个 冒号 、 引 号 不 匹配 或 括号 不 匹配 ， 都 可 能 导致 程 
序 无 法 正确 运行 。 请 再 次 阅读 本 章 的 相关 内 容 ， 并 重新 审视 你 编写 
的 代码 ， 看 看 能 售 找 出 错误 。 

推倒 重 来 。 你 也 许 不 需要 撮 载 任何 软件 ， 但 删除 文件 hello_world.py 
并 重新 创建 它 也 许 是 合理 的 选择 。 

让 列 人 在 你 的 计算 机 或 其 他 计算 机 上 按 本 章 的 步骤 重 做 一 过 ， 并 仔 
细 观 察 。 你 可 能 遗漏 了 一 小 步 ， 而 别人 刚好 没有 遗漏 。 

请 懂 Python 的 人 帮忙 。 当 你 有 这 样 的 想法 时 ， 可 能 发 现在 你 认识 的 
人 当中 束 有 人 使 用 Python。 

本 章 的 安装 说 明 在 本 书 主页 上 : ituring.cn/book/2784。 对 你 来 说 ， 
在 线 版 也 许 更 合适 ， 因 为 可 以 复制 并 粘贴 其 中 的 代码 。 

到 网 上 寻求 帮助 。 附 录 C 提 供 了 很 多 在 线 资 源 ， 如 论坛 或 在 线 聊天 
网 站 ， 你 可 以 在 这 些 地 方 请 求解 决 过 相同 问题 的 人 提供 解决 方案 。 


不 要 担心 这 会 打扰 经 验 丰富 的 程序 员 。 每 个 程序 员 都 遇 到 过 问题 ， 大 多 
数 程序 员 很 乐意 帮助 你 正确 地 设置 系统 。 只 要 能 清晰 地 说 明 你 要 做 什 
么 、 尝 试 了 哪些 方法 及 其 结果 ， 残 很 可 能 有 人 能 够 帮 到 你 。 正 如 前 言 中 
虽 出 的 ，Python 社 区 对 初学 者 非常 友好 。 


任何 现代 计算 机 都 能 够 运行 Python。 前 期 的 问题 可 能 令 人 泪 丧 ， 但 很 值 
得 你 花 时 间 去 解决 。 能 够 运行 hello_world.py 后 ， 你 就 可 以 开始 学 习 
Python 了， 而 且 编 程 工作 会 更 有 趣 ， 也 更 令 人 愉快 。 


1.5 ”从 终端 运行 Python 程序 


你 编写 的 大 多 数 程序 将 直接 在 文本 编辑 器 中 运行 ， 但 有 时 候 从 终端 运行 
程序 很 有 有 用。 例如， 你 可 能 想 直 接 运 行 妹 有 的 程序 。 


在 任何 安装 了 Python 的 系统 上 都 可 以 这 样 做 ， 前 提 是 你 知道 如 何 进入 程 
序 文 件 所 在 的 目录 。 为 尝试 这 样 做 ， 请 确保 将 文件 hello_world.py 存 储 到 
了 和 更 面 的 文件 夹 python_work 中 。 


1.5.1 在 Windows 系 统 中 从 终端 运行 Python 程序 

在 命令 窗口 中 ， 可 以 使 用 终端 命令 cd (表示 change directory， 即 切换 目 
录 ) 在 文件 系统 中 导航 。 使 用 命令 dir (表示 directory， 即 目录 ) 可 以 
显示 当前 目录 中 的 所 有 文件 。 


为 运行 程序 hello_world.py， 请 打开 一 个 新 的 终端 窗口 ， 并 执行 下 面 的 命 
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@ C:\> cd Desktop\python work 
@ C:\Desktop\python work> dir 
hello world.py 


日 C:\Desktop\python work> python hello world.py 
Hello Python world! 


这 里 使 用 了 命令 cd 来 切换 到 文件 洋 Desktop\python_work( 见 @) 。 接 
下 来 ， 使 用 命令 dir 来 确认 这 个 文件 夹 中 包含 文件 hello_world.py“ 见 

@@) 。 最后， 使 用 命令 python hello_world.py 来 运行 这 个 文件 ( 见 
@). 


大 多 数 程序 可 直接 从 编辑 器 运行 ， 但 符 解 决 的 问题 比较 复杂 时 ， 你 编写 
的 程序 可 能 需要 从 终端 运行 。 


1.5.2 ”在 Linux 和 macOS 系 统 中 从 终端 运行 Python 程序 


在 Linuxz 和 macOS 系 统 中 ， 从 终端 运行 Python 程序 的 方式 相同 。 在 终端 会 


话 中 ， 可 以 使 用 终端 命令 cd (表示 change directory， 即 切换 目录 ) 在 
文件 系统 中 导航 。 使 用 命令 1s (表示 list， 即 列表 ) 可 以 显示 当前 目录 
中 所 有 未 隐藏 的 文件 。 


为 运行 程序 hello_world.py， 请 打开 一 个 新 的 终端 窗口 ， 并 执行 下 面 的 命 


令 : 


@ ~$ cd Desktop/python work/ 
@ ~/Desktop/python work$ 1s 
hello world.py 


@ ~/Desktop/python work$ python hello world.py 
Hello Python world! 


这 里 使 用 了 命令 cd 来 切换 到 文件 夹 Desktop/python_work( 见 @) 。 接 
下 来 ， 使 用 命令 1s 来 确认 这 个 文件 夹 中 包含 文件 hello_world.py〔 见 

人 @) 。 最 后 ， 使 用 命令 python hello_world.py 来 运行 这 个 文件 ( 见 
@).， 


就 这 么 简单 。 要 运行 Python 程序 ， 只 需 使 用 命令 python (或 python3 
) 即 可 。 


动手 试 一 试 


本 章 的 练习 都 是 探索 性 的 ， 但 从 第 2 章 开 始 将 要 求 你 用 那 一 章 学 到 
的 知识 来 解决 问题 。 


练习 1-1: python.org ”浏览 Python 主 页 ， 寻 找 你 感 兴趣 的 主题 。 你 
对 Python 越 熟悉 ， 这 个 网 站 对 你 来 说 惑 越 有 用 。 


练习 1-2: 输入 错误 ”打开 你 刚 创 建 的 文件 hello_world.py， 在 代码 
中 添加 一 个 输入 错误 ， 再 运行 这 个 程序 。 输 入 错误 会 引发 错误 吗 ? 
你 能 理解 显示 的 错误 消息 吗 ? 你 能 添加 一 个 不 会 导致 错误 的 输入 错 
误 吗 ?你 赁 什么 认为 它 不 会 导致 错误 ? 


练习 1-3: 无 穷 的 技艺 。 如 果 你 有 无 穷 多 种 编程 拉 艺 ， 你 打算 开发 
什么 样 的 程序 呢 ? 你 束 要 开始 学 习 编程 了 。 如 果 心 中 有 目标 ， 残 能 
立即 将 新 学 到 的 技能 付 诸 应 用 ， 现 在 正 是 草拟 目标 的 大 好 时 机 。 将 


想法 记录 下 来 是 个 不 错 的 习惯 ， 这 样 每 当 需 要 开始 新 项 目 时 ， 都 可 
参考 它们 。 现 在 请 花 点 时 间 描 绘 三 个 你 想 创建 的 程序 。 


1.6 小结 

在 本 章 中 ， 你 大 致 了 解 了 Python， 并 在 自己 的 系统 中 安装 了 Python。 你 
还 安装 了 一 个 文本 编辑 器 ， 以 简化 Python 代码 的 编写 工作 。 你 学 习 了 如 
何在 终端 会 话 中 运行 Python 代码 族 段 ， 并 运行 了 第 一 个 程序 
hello_world.py。 你 还 大 致 了 解 了 如 何 解决 安装 问题 。 


在 下 一 章 ， 你 将 学 习 如 何在 Python 程序 中 使 用 各 种 数据 和 变量 。 


变量 和 简单 数据 类 型 


在 本 章 中 ， 你 将 学 习 可 在 Python 程序 中 使 用 的 各 种 数 
据 ， 还 将 学 习 如 何在 程序 中 使 用 变量 来 表示 这 些 数据 。 


2.1 运行 hello_world.py 时 发 生 的 情况 


运行 hello_world.py 时 ，Python 都 做 了 些 什么 呢 ? 下面 来 深入 研究 一 下 。 
实际 上 ， 即 便 是 运行 简单 的 程序 ，Python 所 做 的 工作 也 相当 多 : 


hello_world.py 


print("Hello Python world!") 


运行 上 述 代 码 时 ， 你 将 看 到 如 下 输出 : 


Hello Python world! 


运行 文件 hello_world.py 时 ， 末 尾 的 .py 指出 这 是 一 个 Python 程 序 ， 因 此 编 
辑 右 将 使 用 Python 解 释 器 来 运行 它 。Python 解 释 器 读 取 整个 程序 ， 确 定 
其 中 每 个 单词 的 含义 。 例 如 ， 看 到 后 面 跟着 圆 括 号 的 单词 print 时 ， 解 
释 右 束 将 圆 括号 中 的 内 容 打 印 到 屏 闫 。 


编写 程序 时 ， 编 辑 器 会 以 各 种 方式 突出 程序 的 不 同 部 分 。 例 如 ， 它 知 
道 print() 是 一 个 函数 的 名 称 ， 因 此 将 其 显示 为 某 种 颜色 ; 它 知 
道 "Hello Python world!" 不 是 Python 代码 ， 因 此 将 其 显示 为 另 一 种 
颜色 。 这 种 功能 称 为 语法 高 亮 ， 在 你 刚 开 始 编写 程序 时 很 有 帮助 。 


2.2 ”变量 


下 面 来 尝试 在 hello_world.py 中 使 用 一 个 变量 。 在 这 个 文件 开头 添加 一 行 
代码 ， 并 对 第 二 行 代码 进行 修改 ， 如 下 所 示 : 


hello_world.py 


message = "Hello Python world!" 
print(message) 


这 个 程序 ， 看 看 结果 如 何 。 你 会 有 友 现 ， 输 出 与 以 前 相同 : 


Hello Python world! 


我 们 添加 了 一 个 名 为 message 的 变量 。 每 个 变量 都 指 同 一 个 值 一 一 与 
该 变量 相关 联 的 信息 。 在 这 里 ， 指 向 的 值 为 文本 "Hello Python 


worldl!l"， 


添加 变量 导致 Python 解 释 器 需要 做 更 多 工作 。 处 理 第 一 行 代 码 时 ， 它 将 
变量 message 与 文本 "Hello Python world!" 关联 起 来 ， 处理 第 二 行 
代码 时 ， 它 将 与 变量 message 关联 的 值 打印 到 屏幕 


下 面 来 进一步 扩展 这 个 程序 : 修改 hello_world.py， 使 其 再 打印 一 条 消 
上 县。 为 此 ， 在 hello_world.py 中 添加 一 个 空 行 ， 再 添加 下 面 两 行 代 码 : 


message = "Hello Python world!" 
print(message) 


message = "Hello Python Crash Course world!" 
print(message) 


现在 如 果 运 行 这 个 程序 ， 将 看 到 两 行 输出 : 


Hello Python world! 
Hello Python Crash Course world! 


在 程序 中 可 随时 修改 变量 的 值 ， 而 Python 将 始终 记录 变量 的 最 新 值 。 


2.2.1 变量 的 命名 和 使 用 


在 Python 中 使 用 变量 时 ， 需 要 遵守 一 些 规则 和 指南 。 违 反 这 些 规则 将 引 
发 错误 ， 而 指南 旨 在 让 你 编写 的 代码 更 容易 阅读 和 理解 。 请 务必 牢记 下 
述 有 关 变 量 的 规则 。 


。 变量 名 只 能 包含 字母 、 数 字 和 下 划 线 。 变 量 名 能 以 字母 或 下 划 线 打 
头 ， 但 不 能 以 数字 打头 。 例 如 ， 可 将 变量 命名 为 message_1 ， 但 不 
能 将 其 命名 为 1_message 。 

变量 名 不 能 包含 空格 ， 但 能 使 用 下 划 线 来 分 隅 其 中 的 单词 。 例 如 ， 
变量 名 greeting_message 可 行 ， 但 变量 名 greeting message 会 
引发 错误 。 

不 要 将 Python 关键 字 和 函数 名 用 作 变 量 名 ， 即 不 要 使 用 Python 保留 
用 于 特殊 用 途 的 单词 ， 如 print (请 参见 附录 A.4) 。 

变量 名 应 既 简 短 又 具有 描述 性 。 例 如 ，name 比 n 

好 ，student_name 比 s_n 好 ，name_length 比 
length_of_persons_name 好 。 


。 恒 用 小 与 字母 1 和 大 写字 母 0 ， 因 为 它们 可 能 被 人 错 看 成 数字 1 和 8 


要 创建 良好 的 变量 名 ， 需 要 经 过 一 定 的 实践 ， 在 程序 复杂 而 有 趣 时 尤其 
如 些 。 随 着 编写 的 程序 越 来 越 多 ， 并 开始 阅读 别人 编写 的 代码 ， 你 将 越 
来 越 善于 创建 有 意义 的 变量 名 。 
注意 ”就 目前 而 言 ， 应 使 用 小 写 的 Python 变量 名 。 虽 然 在 变量 名 中 
使 用 大 写字 母 不 会 导致 错误 ， 但 是 大 写字 母 在 变量 名 中 有 特殊 含 
义 ， 这 将 在 本 书后 面 讨 论 。 
2.2.2 ”使 用 变量 时 避免 命名 错误 


程序 员 痢 会 犯错 ， 而 且 大 多 数 程 序 员 每 天 都 会 犯错 。 虽 然 优 秀 的 程序 员 


也 会 犯错 ， 但 他 们 也 知道 如 何 高 效 地 消除 错误 。 下 面 来 看 一 种 你 可 能 犯 
的 错误 ， 并 学 习 如 何 消除 它 。 

我 们 将 有 意 地 编写 一 些 引 发 错误 的 代码 。 请 输入 下 面 的 代码 ， 包 括 其 中 
拼写 不 正确 、 以 粗 体 显 示 的 单词 mesage : 


message = "Hello Python Crash Course reader!" 
print(mesage) 


程序 存在 错误 时 ，Python 解 释 器 将 竭尽 所 能 地 帮助 你 找 出 问题 所 在 。 程 
序 无 法 成 功 运 行 时 ， 解 释 器 将 提供 一 个 traceback。traceback 是 一 条 记 
录 ， 指 出 了 解释 器 尝试 运行 代码 时 ， 在 什么 地 方 陷 入 了 困境 。 下 面 是 你 
不 小 心 错误 地 拼写 了 变量 名 时 ，Python 解 释 器 提供 的 traceback: 


Traceback (most recent call last): 
@© File "hello world.py", line 2, in <module> 
@ print(mesage) 


©@ NameError: name 'mesage' is not defined 


解释 器 指出 ， 文 件 hello_world.py 的 第 二 行 存在 错误 ( 见 @)。 它 列 出 了 
这 行 代码 ， 则 在 帮助 你 快速 找 出 错误 ( 见 @) ， 还 指出 了 它 发 现 的 是 什 
么 样 的 错误 ( 见 @) 。 在 这 里 ， 解 释 嚣 发现 了 一 个 名 称 错误 ， 并 报告 
打印 的 变量 mesage 未 定义 : Python 无 法 识别 你 提供 的 变量 名 。 名 称 错 
误 通 常 意味 着 两 种 情况 : 要 么 是 使 用 变量 前 忘记 给 它 赋 值 ， 要 么 是 输入 
变量 名 时 拼写 不 正确 。 

在 这 个 示例 中 ， 第 二 行 的 变量 名 message 遗漏 了 字母 s。Python 解 释 器 


不 会 对 代码 做 拼写 检查 ， 但 要 求 变量 名 的 拼写 一 致 。 例 如 ， 如 果 在 代码 
的 男 一 个 地 方 也 将 message 错误 地 拼写 成 了 mesage ， 结 果 将 如 何 呢 ? 


mesage = "Hello Python Crash Course reader!" 
print(mesage) 


在 这 种 情况 下 ， 程 序 将 成 功 运行 ! 


Hello Python Crash Course reader! 


编程 语言 要 求 严 格 ， 但 并 不 关心 拼写 是 否 正确 。 因 此 ， 创 建 变 量 名 和 纺 
写 代 码 时 ， 无 须 考虑 英语 中 的 拼写 和 语法 规则 。 


很 多 编程 错误 都 简单 ， 只 是 在 程序 的 某 一 行 输 错 了 一 个 字符 。 为 找 出 这 
种 错误 而 花费 很 长 时 间 的 大 有 人 在 。 很 多 程序 员 天 资 聪颖 、 经 验 丰富 ， 
却 为 找 出 这 种 细微 的 错误 花费 数 小 时 。 你 可 能 觉得 这 很 好 笑 ， 但 别 忘 
了 ， 在 你 的 编程 生涯 中 ， 经 常会 有 同样 的 遭遇 。 


2.2.3 ”变量 是 标签 

变量 和 常 被 描述 为 可 用 于 存储 值 的 盒子 。 在 你 刚 接 触 变量 时 ， 这 种 定义 可 
能 很 有 帮助 ， 但 它 并 没有 准确 描述 Python 内 部 表示 变量 的 方式 。 一 种 好 
得 多 的 定义 是 ， 变 量 是 可 以 赋 给 值 的 标签 ， 也 可 以 说 变量 指 问 特定 的 


刚 学 习 编 程 时 ， 这 种 差别 可 能 意义 不 大 ， 但 越 早 知道 越 好 。 你 述 早 会 明 
到 变量 的 行为 出 平 意料 的 情形 ， 此 时 如 果 对 变量 的 工作 原理 有 准确 的 认 
识 ， 将 有 助 于 搞 消 楚 代 码 是 如 何 运 行 的 。 


注意 ”要 理解 新 的 编程 概念 ， 最 佳 的 方式 是 尝试 在 程序 中 使 用 它 
们 。 如 果 你 在 完成 本 书 的 练习 时 陷入 了 困境 ， 请 答 试 做 点 其 他 的 事 
情 。 如 果 这 样 做 后 依然 无 法 摆脱 困境 ， 请 复习 相关 内 容 。 如 末 这 样 
做 后 情况 依然 如 故 ， 请 参阅 附录 C 的 建议 。 


动手 试 一 斌 


在 完成 下 面 的 每 个 练习 时 ， 都 编写 一 个 独立 的 程序 。 保 存 每 个 程序 
时 ， 使 用 符合 标准 Python 约定 的 文件 名 : 使 用 小 写字 母 和 下 划 线 ， 


如 simple_message.py 和 simple_messages.py。 


练习 2-1: 简单 消息 ”将 一 条 消 恩 赋 给 变量 ， 并 将 其 打印 出 来 。 


练习 2-2: 多 条 简单 消 轧 ”将 一 条 消息 赋 给 变量 ， 并 将 其 打印 出 
来 ， 再 将 变量 的 值 修改 为 一 条 新 消息 ， 并 将 其 打印 出 来 。 


2.3 字符 串 


大 多 数 程序 定义 并 收集 茶 种 数据 ， 然 后 使 用 它们 来 做 些 有 意义 的 事情 。 
有 鉴于 此 ， 对 数据 进行 分 类 大 有 人 神 益 。 我 们 将 介绍 的 第 一 种 数据 类 型 是 
字符 串 。 字 符 串 虽然 看 似 简单 ， 但 能 够 以 很 多 不 同 的 方式 使 用 。 


字符 串 就 是 一 系列 字符 。 在 Python 中 ， 用 引号 括 起 的 都 是 字符 串 ， 其 中 
的 引号 可 以 是 单 引号 ， 也 可 以 是 双 引 号 ， 如 下 上 所 示 : 


"This is a string." 
"This is also a string.' 


这 种 灵活 性 让 你 能 够 在 字符 串 中 包含 引号 和 搬 扎 : 


'I told my friend, "Python is my favorite language!"' 
"The language 'Python' is named after Monty Python, not the snake." 


"One of Python's strengths is its diverse and supportive community." 


下 面 来 看 一 些 使 用 字符 串 的 方式 。 
2.3.1 ”使 用 方法 修改 字符 串 的 大 小 写 


对 于 字符 串 ， 可 执行 的 最 简单 的 操作 之 一 是 修改 其 中 单词 的 大 小 写 。 请 
看 下 面 的 代码 ， 并 答 试 判断 其 作用 : 


name.py 


name = "ada lovelace" 
print(name.title()) 


将 这 个 文件 保存 为 name.py， 再 运行 它 。 你 将 看 到 如 下 输出 : 


Ada Lovelace 


在 这 个 示例 中 ， 变 量 name 指向 小 写 的 字符 串 "ada lovelace" 。 在 函 
数 调用 print() 中 ， 方 法 title() 出 现在 这 个 变量 的 后 面 。 方 法 是 
Python 可 对 数据 执行 的 操作 。 在 name.tit1le() 中 ，name 后 面 的 句点 
(. ) 让 Python 对 变量 name 执行 方法 title() 指定 的 操作 。 每 个 方法 后 
面 都 跟着 一 对 圆 括号 ， 这 是 因为 方法 通常 需要 额外 的 信息 来 完成 其 工 
作 。 这 种 信息 是 在 圆 括号 内 提供 的 。 函 数 title() 不 需要 额外 的 信息 ， 
因此 它 后 面 的 圆 括号 是 空 的 。 


方法 title() 以 首 字 母 大 写 的 方式 显示 每 个 单词 ， 即将 每 个 单词 的 首 字 
母 都 改 为 大 写 。 这 很 有 用 ， 因为 你 经 常 第 要 将 名 字 视 为 信息 。 例如 ， 你 
可 能 希望 程序 将 值 Ada 、ADA 和 ada 视 为 同一 个 名 字 ， 并 将 它们 都 显示 
为 Ada 。 


还 有 其 他 几 个 很 有 用 的 大 小 写 处 理 方法 。 例 如 ， 要 将 字符 串 改 为 全 部 大 
写 或 全 部 小 写 ， 可 以 像 下 面 这 样 做 : 


name = "Ada Lovelace" 
print(name.upper()) 


print(name.1lower()) 


这 些 代 码 的 输出 如 下 : 


ADA LOVELACE 
ada lovelace 


存储 数据 时 ， 方 法 lower() 很 有 用 。 很 多 时 候 ， 你 无 法 依靠 用 户 来 提供 
正确 的 大 小 写 ， 因 此 需要 将 字符 串 先 转换 为 小 写 ， 再 存储 它们 。 以 后 需 
要 显示 这 些 信息 时 ， 再 将 其 转换 为 最 合适 的 大 小 写 方式 。 


2.3.2 ”在 字符 串 中 使 用 变量 


在 有 些 情况 下 ， 你 可 能 想 在 字符 串 中 使 用 变量 的 值 。 例 如 ， 你 可 能 想 使 
用 两 个 变量 分 别 表示 名 和 姓 ， 然 后 合并 这 两 个 值 以 显示 姓名 : 


full_name.py 


first name = "ada" 
last name = "lovelace" 
@ full name = f"{first name} {last name}" 


print(full name) 


要 在 字符 串 中 插入 变量 的 值 ， 可 在 前 引号 前 加 上 字母 f 〈 见 @@) ， 再 将 
要 插入 的 变量 放 在 花 括 号 内 。 这 样 ， 当 Python 显示 字符 串 时 ， 将 把 每 个 
变量 都 丛 换 为 其 值 。 


这 种 字符 串 名 为 {字符 串 。f 是 format 〈 设 置 格式 ) 的 简写 ， 因 为 Python 
0 
D0 下: 


使 用 f 字 符 串 可 完成 很 多 任务 ， 如 利用 与 变量 关联 的 信息 来 创建 完整 的 
消息 ， 如 下 所 示 : 
first name = "ada" 


last name = "lovelace" 
full name = f"{first name} {last name}" 


@ print(f"Hello, {full name.title()}!") 


在 这 里 ， 一 个 问候 用 户 的 句子 中 使 用 了 完整 的 姓名 ( 见 @) ， 并 使 用 方 
II 
简单 问候 语 : 


Hello, Ada Lovelacel! 


[L 


还 可 以 使 用 字符 串 来 创建 消息 ， 再 把 整 条 消息 赋 给 变量 : 


first name = "ada" 
last name = "lovelace" 
full name = f"{first name} {last name}" 


@ message = f"Hello, {full name.title()}!" 
@ print(message) 


上 述 代 码 也 显示 消息 Hello，Ada Lovelace! ， 但 将 这 条 消息 赋 给 了 
一 个 变量 ( 见 @) ， 这 让 最 后 的 函数 调用 print() 变 得 简单 得 多 ( 见 
@).， 


注意 ”ff 字符 串 是 Python 3.6 引 入 的 。 如 果 你 使 用 的 是 Python 3.5 或 
更 早 的 版 本 ， 需 要 使 用 format() 方法 ， 而 非 这 种 f 语 法 。 要 使 用 方 
法 format() ， 可 在 圆 括号 内 列 出 要 在 字符 串 中 使 用 的 变量 。 对 于 
每 个 变量 ， 都 通过 一 对 花 括 号 来 引用 。 这 样 将 按 顺 序 将 这 些 花 括号 
蔡 换 为 圆 括号 内 列 出 的 变量 的 值 ， 如 下 所 示 : 


full name = "{} {}".format(first name, last name) 


2.3.3 ”使 用 制 表 符 或 换行 符 来 添加 空 日 


在 编程 中 ， 空 日 泛 指 任何 非 打 印字 符 ， 如 空格 、 制 表 符 和 换行 符 。 你 
可 以 使 用 空白 来 组 织 输出 ， 让 用 户 阅 读 起 来 更 容易 。 


要 在 字符 串 中 添加 制 表 符 ， 可 使 用 字符 组 合 \t ， 如 下 述 代 码 的 @ 处 所 
修 \: 


>>> print("Python") 
Python 
@ >>> print("\tPpython") 


Python 


要 在 字符 串 中 添加 换行 符 ， 可 使 用 字符 组 合 \n : 


>>> print("Languages:\nPpython\nC\nJavaScript") 
Languages : 
Python 


CE 
JavaScript 


还 可 在 同一 个 字符 串 中 同时 包含 制 表 符 和 换行 符 。 字 符 串 "\nNt" 让 
Python 换 到 下 一 行 ， 并 在 下 一 行 开 头 添加 一 个 制 表 符 。 下 面 的 示例 演示 
了 如 何 使 用 一 个 单行 字符 串 来 生成 四 行 输出 ， 


>>> print("Languages:\n\tPpython\n\tC\n\tjJavaSscript") 
Languages : 
Python 


C 
JavaScript 


在 接 下 来 的 两 革 中 ， 你 将 使 用 为 数 不 多 的 几 行 代码 来 生成 很 多 行 输出 ， 
届时 制 表 符 和 换行 符 将 提供 极 大 的 帮助 。 


2.3.4 删除 空白 


在 程序 中 ， 额 外 的 空白 可 能 令 人 迷惑 。 对 程序 员 来 说 ， "python' 

和 "python "看 起 来 几乎 没什么 两 样 ， 但 对 程序 来 说 ， 它 们 却 是 两 个 不 
同 的 字符 串 。Python 能 够 发 现 'python ' 中 额外 的 空白 ， 并 认为 它 意 义 
重大 一 一 除非 你 告诉 它 不 是 这 样 的 。 


空 日 很 重要 ， 因 为 你 经 常 需 要 比较 两 个 字符 串 是 否 相 同 。 一 个 重要 的 示 
例 是 ， 在 用 户 登 录 网 站 时 检查 其 用 户 名 。 不 过 在 非常 简单 的 情形 下 ， 额 
外 的 空格 也 可 能 令 人 迷惑 。 所 垃 ， 在 Python 中 删除 用 户 输 入 数据 中 的 多 
余 空 日 易如反掌。 


Python 能 够 找 出 字符 串 开 头 和 末尾 多 余 的 空白 。 要 确保 字符 串 末尾 没有 
空白 ， 可 使 用 方法 rstrip() 。 


@ >>> favorite language = 'python ' 
@ >>> favorite language 

“python 
@ >>> favorite language.rstrip() 


“python 
@ >>> favorite language 
“python 


与 变量 favorite_language 相关 联 的 字符 串 末 尾 有 多 余 的 空 日 ( 见 
@) 。 你 在 终端 会 话 中 向 Python 询 问 这 个 变量 的 值 时 ， 可 看 到 末尾 的 空 
格 〈 见 人 四) 。 对 变量 favorite_language 调用 方法 rstrip() 后 ( 见 
四) ， 这 个 多 余 的 空格 被 删除 了 。 然 而 ， 这 种 删除 只 是 暂时 的 ， 接 下 来 
再 次 询问 favorite_ language 的 值 时 ， 你 会 发 现 这 个 字符 串 与 输入 时 
一 样 ， 依 然 包 含 多 余 的 空白 ( 见 @) 。 


要 永久 删除 这 个 字符 串 中 的 空白 ， 必 须 将 删除 操作 的 结果 关联 到 变量 : 


>>> favorite language “python ” 

@ >>> favorite language = favorite language.rstrip() 
>>> favorite language 
“python 


为 删除 这 个 字符 串 中 的 空白 ， 要 将 其 末尾 的 空白 剔除 ， 再 将 结果 关联 到 
原来 的 变量 ( 见 @) .在 编程 中 ， 经 常 需要 修改 变量 的 值 ， 再 将 新 值 关 
联 到 原来 的 变量 。 这 束 是 变量 的 值 可 能 随 程 序 的 运行 或 用 户 输 入 数据 而 
发 生变 化 的 原因 所 在 。 


你 还 可 以 剔除 字符 串 开 头 的 空白 ， 或 者 同时 剔除 字符 串 两 边 的 空白 。 为 
此 ， 可 分 别 使 用 方法 lstrip() 和 strip() : 


@ >>> favorite language = ' python 

@ >>> favorite language.rstrip() 
" python’ 

@ >>> favorite language.1lstrip() 
“python 

@ >>> favorite language.strip() 
“python 


RE 


在 这 个 示例 中 ， 我 们 首先 创建 了 一 个 开头 和 末尾 都 有 空白 的 字符 串 ( 见 
@) 。 接 下 来 ,分 别 删 除 末 尾 〔 见 人 @) 、 开 头 《〈 见 全) 和 两 边 〈 见 @@) 
的 空白 。 答 试 使 用 这 些 剥 除 函 数 有 助 于 你 熟悉 字符 串 操 作 。 在 实际 程序 
中 ， 这 些 剥 除 函 数 最 常用 于 在 存储 用 户 输入 前 对 其 进行 清理 。 


2.3.5 ”使 用 字符 串 时 避免 语法 错误 


语法 错误 是 一 种 你 时 不 时 会 遇 到 的 错误 。 程 序 中 包含 非法 的 Python 代码 
时 ， 就 会 导致 语法 错误 。 例 如 ， 在 用 单 引号 括 起 的 字符 串 中 ， 如 果 包 含 
撤 写 ， 束 将 导致 错误 。 这 是 因为 这 会 导致 Python 将 第 一 个 单 引号 和 撤 号 
ee 进而 将 余下 的 文本 视 为 Python 代 码 ， 从 而 
引 友 错误 。 


下 面 演示 了 如 何 正确 地 使 用 单 引号 和 双 引 号 。 请 将 该 程序 保存 为 
apostrophe.py， 再 运行 它 : 


apostrophe.py 


message = "One of Python's strengths is its diverse community." 
print(message) 


Uo 两 个 双 引 号 之 间 ， 因 此 Python 解释 器 能 够 正确 地 理解 这 个 字符 


One of Python 's strengths is its diverse community. 


然而 ， 如 宁 使 用 单 引 号 ，Python 将 无 法 正确 地 确定 字符 串 的 结束 位 置 : 


message = 'One of Python's strengths is :its diverse Community ." 
print(message) 


你 将 看 到 如 下 输出 : 


File "apostrophe.py", line 1 
message = 'One of Python's strengths is its diverse community.'" 
八 


SyntaxError: invalid syntax 


从 上 述 输出 可 知 ， 错 误 发 生 在 第 二 个 单 引号 后 面 ( 见 @)〉，。 这 种 语法 错 
误 表 明 ， 在 解释 器 看 来 ， 其 中 的 有 些 内 容 不 是 有 效 的 Python 代码 。 错 误 
的 原因 各 种 各 样 ， 我 将 指出 一 些 常 见 的 原因 。 学 习 编 写 Python 代 码 时 ， 
你 可 能 会 经 第 过 到 语法 错误 。 语 法 错误 也 是 最 不 具体 的 错误 类 型 ， 因 此 
ne 
建议 。 


注意 ”编写 程序 时 ， 编 辑 器 的 语法 高 之 功能 可 帮助 你 快速 找 出 某 
些 语法 错误 。 看 到 Python 代码 以 普通 句子 的 颜色 显示 ， 或 者 普通 名 
人 
配 的 情况 。 


动手 试 一 试 


完成 下 面 的 每 个 练习 时 ， 都 编写 一 个 独立 的 程序 ， 并 将 其 保存 为 名 
称 类 似 于 name_cases.py 的 文件 。 如 果 遇 到 了 困难 ， 请 休 奶 一 会 儿 或 
参阅 附录 C 提 供 的 建议 。 


练习 2-3: 个 性 化 消 轧 ”用 变量 表示 一 个 人 的 名 字 ， 并 同 其 显示 一 
条 消 轧 。 显 示 的 消息 应 非常 简单 ， 下 面 是 一 个 例子 。 


Hello Eric, would you like to learn some Python today? 


练习 2-4: 调整 名 字 的 大 小 写 ” 用 变量 表示 一 个 人 的 名 字 ， 再 以 小 
写 、 大 写 和 首 字母 大 写 的 方式 显示 这 个 人 名 。 


练习 2-5: 名 言 “” 找 一 句 你 钦佩 的 名 人 说 的 名 言 ， 将 其 姓名 和 名 言 
打印 出 来 。 输 出 应 类 似 于 下 面 这 样 (包括 引 写 )〉。 


Albert Einstein once said, “A person who never made a mistake 
never tried anything new.” 


练习 2-6: 名 言 2 ”重复 练习 2-5， 但 用 变量 famous_person 表示 名 
人 的 姓名 ， 再 创建 要 显示 的 消息 并 将 其 赋 给 变量 message ， 然 后 打 
印 这 条 消息 。 


练习 2-7: 殊 除 人 名 中 的 空白 ”用 变量 表示 一 个 人 的 名 字 ， 并 在 其 
开头 和 末尾 都 包含 一 些 空 白字 符 。 务 必 人 至少 使 用 字符 组 合 "\t" 
和 "\n" 各 一 次 。 


打印 这 个 人 名 ， 显 示 其 开头 和 末尾 的 空白 。 然 后 ， 分 别 使 用 剔除 函 
数 1strip() 、rstrip() 和 strip() 对 人 名 进行 处 理 ， 并 将 结果 
打印 出 来 。 


2.4 数 


在 编程 中 ， 经 常 使 用 数 来 记录 得 分 、 表 示 可 视 化 数据 、 存 储 Web 应 用 信 
晨 ， 等 等 。Python 能 根据 数 的 用 法 以 不 同 的 方式 处 理 它们 。 鉴 于 整数 使 
用 起 来 最 简单 ， 下 面 就 先 来 看 看 Python 是 如 何 管理 它们 的 。 


2.4.1 整数 


在 Python 中 ， 可 对 整数 执行 加 (+ ) 减 (- ) 乘 (* ) 除 (/ ) 运算 。 


在 终端 会 话 中 ，Python 直 接 返 回 运算 结果 。Python 使 用 两 个 乘 号 表示 乘 
方 运算 : 


> 
9 
> 小 少 人 5 
27 


>>> 168 ** 6 
16666060 


Python 还 支持 运算 次 序 ， 因 此 可 在 同一 个 表达 式 中 使 用 多 种 运算 。 还 可 
以 使 用 加 括号 来 修改 运 第 次 序 ， 让 Python 按 你 指定 的 次 序 执行 运 算 ， 如 
下 所 示 ; 


>>> 2 + 3*4 
14 
>>> (2 + 3) * 4 


， 


在 这 些 示例 中 ， De ee 它们 的 存在 则 在 
让 你 在 阅读 代码 时 能 迅速 确定 先 执 行 哪 些 运算 。 


2.4.2 浮 点 数 


Python 将 所 有 带 小 数 点 的 数 称 为 浮 点 数 。 大 多 数 编程 语言 使 用 了 这 个 术 
语 ， 它 指出 了 这 样 一 个 事实 : 小 数 点 可 出 现在 数 的 任何 位 置 。 每 种 编程 
语言 都 必须 细心 设计 ， 以 妥善 地 处 理 浮 点 数 ， 确 保 不 管 小 数 点 出 现在 什 
么 位 置 ， 数 的 行为 都 是 正常 的 。 


从 很 大 程度 上 说 ， 使 用 浮 点 数 时 无 须 考虑 其 行为 。 你 只 需 输 入 要 使 用 的 
数 ，Python 通 常会 按 你 期 望 的 方式 处 理 它 们 : 


>>> 0.1 .01 
0.2 
>7> 82 + 02 


但 需要 注意 的 是 ， 结 果 包 含 的 小 数位 数 可 能 是 不 确定 的 : 


>>> 0.2 + 0.1 
0.36606660606060606006060060060064 
>>> 3 * 0.1 


0.306600660660606006000600604 


所 有 语言 都 存在 这 种 问题 ， 没 有 什么 可 担心 的 。Python 会 尽力 找到 一 种 
精确 表示 结果 的 方法 ， 但 鉴于 计算 机 内 部 表示 数 的 方式 ， 这 在 有 些 情况 
下 很 难 。 就 现在 而 言 ， 暂 时 忽略 多 余 的 小 数位 数 即 可 。 在 第 二 部 分 的 项 
目 中 ， 你 将 在 需要 时 学 习 处 理 多 余 小 数位 的 方式 。 


2.4.3 ”整数 和 浮 点 数 


将 任意 两 个 数 相 除 时 ， 结 末 总 是 译 点 数 ， 即 便 这 两 个 数 都 是 整数 且 能 整 
除 : 


>>> 4/2 
2.0 


在 其 他 任何 运算 中 ， 如 果 一 个 操作 数 是 整数 ， 为 一 个 操作 数 是 浮 点 数 ， 
结果 也 总 是 浮 点 数 : 


>>> 3.0 ** 2 
9.0 


无 论 是 哪 种 运算 ， 只 要 有 操作 数 是 浮 点 数 ，Python 默 认得 到 的 总 是 浮 反 
数 ， 即 便 结果 原本 为 整数 也 是 如 此 。 


2.4.4” 数 中 的 下 划 线 
书写 很 大 的 数 时 ， 可 使 用 下 划 线 将 其 中 的 数字 分 组 ， 使 其 更 清晰 易 读 : 


>>> universe _ age = 14 666 666 666 


当 你 打印 这 种 使 用 下 划 线 定义 的 数 时 ，Python 不 会 打印 其 中 的 下 划 线 : 


>>> print(universe age) 
14666666660 


这 是 因为 存储 这 种 数 时 ，Python 会 忽略 其 中 的 下 划 线 。 将 数字 分 组 时 ， 
即便 不 是 将 每 三 位 分 成 一 组 ， 也 不 会 影响 最 终 的 值 。 在 Python 看 
来 ，1666 与 1 666 没什么 不 同 ，1_666 与 16_66 也 没什么 不 同 。 这 种 
表示 法 适用 于 整数 和 浮 点 数 ， 但 只 有 Python 3.6 和 更 高 的 版 本 文 持 。 


2.4.5 ”同时 给 多 个 变量 赋值 


可 在 一 行 代码 中 给 多 个 变量 赋值 ， 这 有 助 于 缩短 程序 并 提高 其 可 读 性 。 
这 种 做 法 最 常用 于 将 一 系列 数 赋 给 一 组 变量 。 


例如 ， 下 面 演示 了 如 何 将 变量 x 、y 和 z 都 初始 化 为 零 : 


>>> x, y, Zz = 608, 06, 0 


这 样 做 时 ， 需 要 用 逗号 将 变量 名 分 开 ;， 对 于 要 赋 给 变量 的 值 ， 也 需 同 样 
处 理 。Python 将 按 顺 序 将 每 个 值 赋 给 对 应 的 变量 。 只 要 变量 和 值 的 个 数 
相同 ，Python 就 能 正确 地 将 它们 关联 起 来 。 


2.4.6 ”常量 
常量 类 似 于 变量 ， 但 其 值 在 程序 的 整个 生命 周期 内 保持 不 变 。Python 没 


有 内 置 的 帝 量 类 型 ， 但 Python 程序 员 会 使 用 全 大 写 来 指出 应 将 茶 个 变量 
视 为 常量 ， 其 值 应 始终 不 变 : 


MAX_CONNECTIONS = 5666 


在 代码 中 ， 要 指出 应 将 特定 的 变量 视 为 常量 ， 可 将 其 字母 全 部 大 写 。 
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练习 2-8: 数字 8 ”编写 四 个 表达 式 ， 分 别 使 用 加 法 、 减 法 、 乘 法 和 
除法 运算 ， 但 结果 都 是 数字 8。 为 使 用 函数 调用 print() 来 显示 结 
果 ， 务 必 将 这 些 表 达 式 用 圆 括 号 括 起 来 。 也 就 是 说 ， 你 应 该 编写 四 
行 类 似 于 下 面 的 代码 : 


print(5+3) 


输出 应 为 四 行 ， 其 中 每 行 都 只 包含 数字 8。 


练习 2-9: 最 辟 欢 的 数 ” 用 一 个 变量 来 表示 你 最 喜欢 的 数 ， 再 使 用 
这 个 变量 创建 一 条 消 轧 ， 指 出 你 最 辟 欢 的 数 是 什么 ， 然 后 将 这 条 消 
县 打印 出 来 。 


2.5 注释 


在 大 多 数 编程 语言 中 ， 注 释 是 一 项 很 有 用 的 功能 。 本 书 前 面 编写 的 程序 
中 都 只 包 仿 Python 代码 ， 但 随 着 程序 越 来 越 大 、 越 来 越 复杂 ， 殊 应 在 其 
中 添加 说 明 ， 对 你 解决 问题 的 方法 进行 大 致 的 亲 述 。 注 释 让 你 能 够 使 
用 目 然 语言 在 程序 中 添加 说 明 。 


2.5.1 ”如 何 编写 注释 


在 Python 中 ， 注 释 用 井 号 〈# ) 标识 。 井 号 后 面 的 内 容 都 会 被 Python 解 
释 需 忽略 ， 如 下 所 未 : 


comment.py 


# 疝 大 家 问好 。 
print("Hello Python people!") 


Python 解 释 器 将 忽略 第 一 行 ， 只 执行 第 二 行 。 


Hello Python people! 


2.5.2 ”该 编写 什么 样 的 注释 


编写 注释 的 主要 目的 是 阐述 代码 要 做 什么 ， 以 及 是 如 何 做 的 。 在 开发 项 
目 期 间 ， 你 对 各 个 部 分 如 何 协同 工作 了 如 指 掌 ， 但 过 段 时 间 后 ， 有 些 细 
市 你 可 能 不 记得 了 。 当 然 ， 你 总 是 可 以 通过 研究 代码 来 确定 各 个 部 分 的 
工作 原理 ， 但 通过 编写 注释 以 清晰 的 目 然 语言 对 解决 方案 进行 概述 ， 可 
市 省 很 多 时 间 。 


要 成 为 专业 程序 员 或 与 其 他 程序 员 合作 ， 就 必须 编写 有 意义 的 注释 。 当 
前 ， 大 多 数 软件 是 合作 编写 的 ， 编 写 者 可 能 是 同一 家 公司 的 多 名 员工 ， 
也 可 能 是 众多 致力 于 同一 个 开源 项 目的 人 员 。 训 练 有 素 的 程序 员 痢 希望 
代码 中 包含 注释 ， 因 此 你 最 好 从 现在 开始 就 在 程序 中 添加 描述 性 注释 。 


作为 新 手 ， 最 值得 养 成 的 习惯 之 一 就 是 在 代码 中 编写 清晰 、 简 洁 的 注 


释 。 


如 果 不 确 定 是 否 要 编写 注释 ， 就 问 问 自己 ， 在 找到 合理 的 解决 方案 之 
前 ， 考 虑 了 多 个 解决 方案 吗 ?如 果 答案 是 肯定 的 ， 就 编写 注释 对 你 的 解 
决 方案 进行 说 明 吧 。 相 比 回 过 头 去 再 添加 注释 ， 删 除 多 余 的 注释 要 容易 
得 多 。 从 现在 开始 ， 本 书 的 示例 都 将 使 用 注释 来 讲述 代码 的 工作 原理 。 
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练习 2-10: 添加 注释 ”选择 你 编写 的 两 个 程序 ， 在 每 个 程序 中 至 
少 添加 一 条 注释 。 如 果 程 序 太 简单 ， 实 在 没有 什么 需要 说 明 的 ， 就 
在 程序 文件 开 头 加 上 你 的 姓名 和 当前 日 期 ， 再 用 一 句 话 前 述 程序 的 
功能 。 


2.6 ”Python 之 禅 


经 验 丰富 的 程序 员 倡 导 尽 可 能 避 繁 就 简 。Python 社 区 的 理念 都 包含 在 

Tim Peters 撰 写 的 "Python 之 祥 ” 中 。 要 获悉 这 些 有 关 编 写 优秀 Python 代码 
的 指导 原则 ， 只 需 在 解释 器 中 执行 命令 import this 。 这 里 不 打算 效 
述 整 个 “python 之 禅 "， 而 只 与 大 家 分 享 其 中 的 几 条 原则 ， 让 你 明白 为 何 
它们 对 Python 新 手 来 说 至 关 重 要 。 


>>> import this 
The Zen of Python，by Tim Peters 


Beautiful is better than ugly. 


Python 程序 员 笃 信人 代码 可 以 编写 得 漂亮 而 优雅 。 编 程 是 要 解决 问题 的 ， 
设计 民 好 、 高 效 而 漂亮 的 解决 方案 都 会 让 程序 员 心 生 和 敬意 。 随 者 你 对 
Python 的 认识 越 来 越 深入 ， 并 使 用 它 来 编写 越 来 越 多 的 代码 ， 有 一 天 也 
许 会 有 人 站 在 你 后 面 惊 呼 :“ 哇 ， 代 码 编写 得 真是 漂亮 ! ” 


Simple is better than complex. 


如 果 有 两 个 解决 方案 ， 一 个 简单 、 一 个 复杂 ， 但 都 行 之 有 效 ， 就 选择 简 
单 的 解决 方案 吧 。 这 样 ， 你 编写 的 代码 将 更 容易 维护 ， 你 或 他 人 以 后 改 
进 这 些 代码 时 也 会 更 容易 。 


Complex is better than complicated. 


现实 是 复杂 的 ， 有 时 候 可 能 没有 简单 的 解决 方案 。 在 这 种 情况 下 ， 就 选 
择 最 简单 可 行 的 解决 方案 吧 。 


Readability counts . 


即便 是 复杂 的 代码 ， 也 要 让 它 易 于 理解 。 开 发 的 项 目 涉 及 复杂 代码 时 ， 
一 定 要 为 这 些 代码 编写 有 益 的 注释 。 


There should be one-- and preferably only one --obvious way to do it. 


如 果 让 两 名 Python 程 序 员 去 解决 同一 个 问题 ， 他 们 提供 的 解决 方案 应 大 
致 相同 。 这 并 不 是 说 编程 没有 创意 空间 ， 而 是 恰恰 相反 ! 然而 ， 大 部 分 
编程 工作 是 使 用 币 见 解决 方案 来 解决 简单 的 小 问题 ， 但 这 些小 问题 都 包 
含 在 更 庞大 、 更 有 创意 空间 的 项 目 中 。 在 你 的 程序 中 ， 各 种 具体 细 下 对 
其 他 Python 程序 员 来 说 都 应 易于 理解 。 


Now is better than never . 


你 可 以 用 余生 来 学 习 Python 和 编程 的 纷 索 难 懂 之 处 ， 但 这 样 你 什么 项 目 
都 完 不 成 。 不 要 企图 编写 完美 无 缺 的 代码 ， 而 是 要 先 编写 行 之 有 效 的 代 
码 ， 再 决定 是 对 其 做 进一步 改进 ， 还 是 转 而 去 编写 新 代码 。 


等 你 进入 下 一 章 ， 开 始 研究 更 复杂 的 主题 时 ， 务 必 牢 记 这 种 简约 而 清晰 
的 理念 。 如 此 ， 经 验 丰 富 的 程序 员 定 将 对 你 编写 的 代码 心 生 敬 意 ， 进 而 
乐意 向 你 提供 反馈 ， 并 与 你 合作 开发 有 趣 的 项 目 。 

动手 试 一 斌 


练习 2-11: Python 之 禅 ”在 Python 终端 会 话 中 执行 命令 import 
this ， 并 粗略 地 浏览 一 下 其 他 的 指导 原则 。 


2.7 2 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 变量 ， 如 何 创 建 描述 性 变量 名 以 及 如 何 
消除 名 称 错误 和 语法 错误 ;字符 串 是 什么 ， 以 及 如 何 使 用 小 写 、 大 写 和 
首 字母 大 与 方式 显示 字符 串 ， 使 用 空 日 来 显示 整洁 的 输出 ， 以 及 如 何 吻 
除 字符 串 中 多 余 的 空白 ; 如 何 使 用 整数 和 浮 点 数 ， 一 些 使 用 数值 数据 的 
方式 。 你 还 学 习 了 如 何 编 写 说 明 性 注释 ， 让 代码 对 你 和 其 他 人 来 说 更 容 
易 理 解 。 最 后 ， 你 了 解 了 让 代码 尽 可 能 简单 的 理念 。 


在 第 3 音 ， 你 将 学 习 如 何在 被 称 为 列表 的 变量 中 存储 一 系列 信息 ， 以 及 
如 何 通过 遇 历 列表 来 操作 其 中 的 信息。 


列表 简介 


在 本 章 和 下 一 章 中 ， 你 将 学 习 列 表 是 什么 以 及 如 何 使 
用 列表 元 素 。 列 表 让 你 能 够 在 一 个 地 方 存储 成 组 的 信息 ， 其 中 可 以 
只 包含 几 个 元 素 ， 也 可 以 包含 数 百 万 个 元 素 。 列 表 是 新 手 可 直接 使 
用 的 最 强大 的 Python 功能 之 一 ， 它 融合 了 众多 重要 的 编程 概念 。 


3.1 列表 是 什么 


列表 由 一 系列 按 特 定 顺序 排列 的 元 素 组 成 。 你 可 以 创建 包含 字母 表 中 
所 有 字母 、 数 字 0 一 9 或 所 有 家 诗 成 员 姓 名 的 列表 ; 也 可 以 将 任何 东西 加 
人 列表 中 ， 其 中 的 元 系 之 间 可 以 没有 任何 关系 。 列表 通常 包含 多 个 元 
素 ， 因 此 给 列表 指定 一 个 表示 复数 的 名 称 (如 letters 、digits 

或 names ) 是 个 不 错 的 主音 。 


在 Python 中 ， 用 方 括号 〈([] 〉 表示 列 表 ， 并 用 去 号 分 阳 其 中 的 元 素 。 下 
面 是 一 个 简单 的 列表 示例 ， 其 中 包含 儿 种 自行 车 : 


bicycles.py 


bicycles = ['trek', 'cannondale', 'redline', 'specialized'] 
print(bicycles) 


各 果 让 Python 举 列表 打印 出 来，Python 将 打印 列 表 的 内 部 表示 ， 包 括 方 
舌 号 : 


['trek', 'cannondale', 'redline', "specialized '] 


鉴于 这 不 是 你 要 让 用 户 看 到 的 输出 ， 下 面 来 学 习 如 何 访 问 列表 元 系 。 


3.1.1 访问 列表 元 素 

列表 是 有 序 集合 ， 因 此 要 访问 列表 的 任意 元 素 ， 只 需 将 该 元 素 的 位 置 
(索引 ) 告诉 Python 即 可 。 要 访问 列表 元 素 ， 可 指出 列表 的 名 称 ， 再 指 
出 元 素 的 索引 ， 并 将 后 者 放 在 方 括号 内 。 


例如 ， 下 面 的 代码 从 列表 bicycles 中 提取 第 一 款 自 行车 : 


bicycles = ['trek', 'cannondale', 'redline', "Specialized '] 
@ print(bicycles[6]) 


= 和 "= 


@@ 处 演示 了 访问 列表 元 素 的 语法 。 当 你 请 求 获取 列表 元 素 时 ，Python 只 
返回 该 元 素 ， 而 不 包括 方 括号 : 


这 正 是 你 要 让 用 户 看 到 的 结果 一 一 整洁 、 干 净 的 输出 。 


你 还 可 以 对 任意 列表 元 素 调用 第 2 章 介 绍 的 字符 串 方法 。 例 如 ， 可 使 用 
方法 title() 让 元 素 'trek' 的 格式 更 整洁 : 


bicycles = ['trek', 'cannondale', 'redline', 'specialized'] 
print(bicycles[6].title()) 


这 个 示例 的 输出 与 前 一 个 示例 相同 ， 只 是 首 字母 T 是 大 写 的 。 

3.1.2 ”索引 从 0 而 不 是 1 开始 

在 Python 中 ， 第 一 个 列表 元 素 的 索引 为 0， 而 不 是 1。 多 数 编程 语言 是 如 
此 规定 的 ， 这 与 列表 操作 的 底层 实现 相关 。 如 果 结 果 出 乎 意料 ， 请 看 看 
你 是 否 犯 了 简单 的 差 一 错误 。 

第 二 个 列表 元 和 妹 的 索引 为 1。 根 据 这 种 简单 的 计数 方式 ， 要 访问 列表 的 
任何 元 素 ， 都 可 将 其 位 置 减 1， 并 将 结果 作为 索引 。 例 如 ， 要 访问 第 四 
个 列表 元 素 ， 可 使 用 索引 3。 


下 面 的 代码 访问 索引 1 和 索引 3 处 的 自行 车 : 


bicycles = ['trek', 'cannondale', 'redline', "Specialized '] 
print(bicycles[1]) 


print(bicycles[3]) 


这 些 代 码 返 回 列表 中 的 第 二 个 和 第 四 个 元 素 : 


cannondale 
specialized 


Python 为 访问 最 后 一 个 列表 元 素 提 供 了 一 种 特殊 语法 。 通 过 将 索引 指定 
为 -1 ， 可 让 Python 返回 最 后 一 个 列表 元 素 : 


bicycles = [ trek'， 'cannondale', 'redline', "Specialized '] 
print(bicycles[-1]) 


这 上 段 代 码 返 回 'specialized' 。 这 种 语法 很 有 用 ， 因 为 你 经 党 需要 在 
不 知道 列表 长 度 的 情况 下 访问 最 后 的 元 素 。 ee 
索引 。 例 如， 索引 -2 返回 倒数 第 二 个 列表 元 素 ， 索 引 -3 返回 倒数 第 

个 列表 元 素 ， 依 此 类 推 。 


3.1.3 ”使 用 列表 中 的 各 个 值 


你 可 以 像 使 用 其 他 变量 一 样 使 用 列表 中 的 各 个 值 。 例 如 ， 可 以 使 用 竺 
符 吕 根据 列表 中 的 值 来 创建 消息 。 


下 面 尝 试 从 列表 中 提取 第 一 球 目 行车 ， 并 使 用 这 个 值 创建 一 条 消 筷 : 


bicycles = ['trek', 'cannondale', 'redline', "Specialized '] 
@ message = f"My first bicycle was a {bicycles[8].title()}." 


print(message) 


我 们 使 用 bicycles[8] 的 值 生 成 了 一 个 句子 ， 并 将 其 赋 给 变量 message 
( 见 @) 。 输出 是 一 个 简单 的 句子 ， 其 中 包含 列表 中 的 第 一 球 自 行车 : 


My first bicycle was a Trek. 


动手 试 一 斌 


请 答 试 编写 一 些 简短 的 程序 来 完成 下 面 的 练习 ， 以 获得 一 些 使 用 
Python 列表 的 第 一 手 经 验 。 你 可 能 需要 为 每 章 创 建 一 个 文件 夹 ， 以 
整洁 有 序 的 方式 存储 为 完成 各 章 的 练习 而 编写 的 程序 。 


练习 3-1: 姓名 ”将 一 些 朋 友 的 姓名 存储 在 一 个 列表 中 ， 并 将 其 命 
i 0 
J 印 出 来 。 


练习 3-2: 问候 语 继续 使 用 练习 3-1 中 的 列表 ， 但 不 打印 每 个 朋友 
的 姓名 ， 而 为 每 人 打印 一 条 消息 。 每 条 消息 都 包含 相同 的 问候 语 ， 
但 抬头 为 相应 朋友 的 姓名 。 


练习 3-3: 自己 的 列表 。” 想 想 你 喜欢 的 通勤 方式 ， 如 骑 摩 托 车 或 开 
汽车 ， 并 创建 一 个 包含 多 种 通勤 方式 的 列表 。 根 据 该 列表 打印 一 系 
列 有 关 这 些 通 勤 方 式 的 宣言 ， 下 面 是 一 个 例子 。 


I would like to own a Honda motorcycle. 


3.2 修改、 添加 和 删除 元 素 


你 创建 的 大 多 数列 表 将 是 动态 的 ， 这 意味 着 列表 创建 后 ， 将 随 着 程序 的 
运行 增删 元 素 。 例 如 ， 你 创建 一 个 游戏 ， 要 求 玩家 射 杀 从 天 而 降 的 外 星 
人 。 为 此 ， 可 在 开始 时 将 一 些 外 星人 存储 在 列表 中 ， 然 后 每 当 有 外 星人 
被 射 杀 时 ， 都 将 其 从 列表 中 删除 ， 而 每 次 有 新 的 外 星人 出 现在 屏幕 上 

0 


3.2.1 ”修改 列表 元 素 


修改 列表 元 系 的 语法 与 访问 列表 元 系 的 语法 类 似 。 要 修改 列表 元 素 ， 可 
旨 定 列表 名 和 要 修改 的 元 素 的 索引 ， 再 指定 该 元 素 的 新 值 。 


例如 ， 假 设 有 一 个 摩托 车 列表 ， 其 中 的 第 一 个 元 素 为 "honda' ， 如 何 修 
改 它 的 值 呢 ? 


motorcycles.py 


@ motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles) 


@ motorcycles[6] = 'ducati' 
print(motorcycles) 


首先 定义 一 个 摩托 车 列表 ， 其 中 的 第 一 个 元 素 为 'honda' ( 见 @) . 接 
下 来 ， 将 第 一 个 元 素 的 值 改 为 'ducati' ( 见 @) 。 输 出 表明 ， 第 一 个 
元 素 的 值 确 实 变 了 ， 但 其 他 列表 元 素 的 值 没 变 : 


['honda', 'yamaha', 'suzuki'] 
['ducati', 'yamaha', "Suzuki '] 
y 


你 可 以 修改 任意 列表 元 际 的 值 ， 而 不 仅仅 是 第 一 个 元 素 的 值 。 


3.2.2 ”在 列表 中 添加 元 素 


你 可 能 出 于 众多 原因 要 在 列表 中 添加 新 元 素 。 例 如 ， 你 可 能 希望 游戏 中 
出 现 新 的 外 星人 、 添 加 可 视 化 数据 或 给 网 站 添加 新 注册 的 用 户 。Python 
提供 了 多 种 在 既 有 列表 中 添加 新 数据 的 方式 。 


01. 在 列表 末尾 谎 加 元 素 
在 列表 中 添加 新 元 素 时 ， 最 简单 的 方式 是 将 元 素 附 加 〈append) 到 


列表 。 给 列表 附加 元 素 时 ， 它 将 添加 到 列表 末尾 。 继 续 使 用 前 一 个 
示例 中 的 列表 ， 在 其 末尾 添加 新 元 素 "ducati'" : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles) 


@ motorcycles.append('ducati') 
print(motorcycles) 


方法 append( ) 将 元 素 ' ducati' 添加 到 列表 末尾 ( 见 @) ， 而 不 
影响 列表 中 的 其 他 所 有 元 素 : 


['honda', 'yamaha', 'suzuki'] 
['honda', 'yamaha', 'suzuki', 'ducati'] 


方法 append() 让 动态 地 创建 列表 易如反掌 。 例 如 ， 你 可 以 先 创 建 
一 个 空 列表 ， 再 使 用 一 系列 函数 调用 append() 来 添加 元 素 。 下 面 
来 创建 一 个 空 列 表 ， 再 在 其 中 添加 元 素 'honda' 、 "yamaha' 


和 "suzuki ' : 


motorcycles = [] 


motorcycles.append( 'honda') 
motorcycles.append( 'yamaha') 
motorcycles.append('suzuki') 


print(motorcycles) 


| | 
最 终 的 列表 与 前 述 示例 中 的 列表 完全 相同 : 


['honda', 'yamaha', 'suzuki'] 


这 种 创建 列表 的 方式 极其 常见 ， 因 为 经 常 要 等 程序 运行 后 ， 你 才 知 
道 用 户 要 在 程序 中 存储 哪些 数据 。 为 控制 用 户 ， 可 首先 创建 一 个 空 
人 
NE 


02. 在 列表 中 插入 元 素 


使 用 方法 insert() 可 在 列表 的 任何 位 置 汪 加 新 元 素 。 为 此 ， 你 需 
要 指定 新 元 素 的 索引 和 值 。 


motorcycles = ['honda', 'yamaha', 'suzuki'] 


@ motorcycles.insert(6， 'ducati') 


print(motorcycles) 


在 这 个 示例 中 ， 值 'ducati' 被 插入 到 了 列表 开头 〔 见 @) 。 方 法 
insert() 在 索引 8 处 添加 空间 ， 并 将 值 "ducati' 存储 到 这 个 地 
方 。 这 种 操作 将 列表 中 既 有 的 每 个 元 素 都 右 移 一 个 位 置 : 


['ducati', 'honda', 'yamaha', "Suzuki '] 


3.2.3 ”从 列表 中 删除 元 素 


你 经 党 需要 从 列表 中 删除 一 个 或 多 个 元 素 。 例 如 ， 玩 家 将 空中 的 一 个 外 
星人 射 杀 后 ， 你 很 可 能 要 将 其 从 存活 的 外 星人 列表 中 删除 ， 当 用 户 在 你 
创建 的 web 应 用 中 注销 账户 时 ， 你 就 需要 将 该 用 户 从 活动 用 户 列表 中 删 


除 。 你 可 以 根据 位 置 或 值 来 删除 列表 中 的 元 稍 。 
01. 使 用 del 语句 删除 元 素 
如 末 知 道 要 删除 的 元 素 在 列表 中 的 位 置 ， 可 使 用 del 语句 。 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles) 


@ del motorcycles[6] 
print(motorcycles) 


@@ 处 的 代码 使 用 del 删除 了 列表 motorcycles 中 的 第 一 个 元 
素 'honda ' : 


['honda', 'yamaha', 'suzuki'] 
['yamaha', 'suzuki'] 


使 用 del 可 删除 任意 位 置 处 的 列表 元 系 ， 条 件 是 知道 其 索引 。 例 
如 ， 下 面 演示 了 如 何 删 除 前 述 列表 中 的 第 二 个 元 系 'yamaha' : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles) 


del motorcycles[1] 
print(motorcycles) 


下 面 的 输出 表明 ， 已 经 将 第 二 款 摩 托 车 从 列表 中 删除 了 : 


['honda', "yamaha ' ， 
['honda', "Suzuki 


在 这 两 个 示例 中 ， 使 用 del 语句 将 值 从 列表 中 删除 后 ， 你 就 无 法 再 


02. 


访问 它 了 。 

使 用 方法 pop() 删除 元 素 

有 时 候 ， 你 要 将 元 系 从 列表 中 删除 ， 并 接着 使 用 它 的 值 。 例 如 ， 你 
可 能 需要 获取 刚 被 射 杀 的 外 星人 的 z 坐标 和 y 坐标 ， 以 便 在 相应 的 


位 置 显 示 爆 炸 效果 ; 在 Web 应 用 程序 中 ， 你 可 能 要 将 用 户 从 活跃 成 
员 列 表 中 删除 ， 并 将 其 加 入 到 非 活跃 成 员 列 表 中 。 

方法 pop() 删除 列表 末尾 的 元 素 ， 并 让 你 能 够 接 独 使 用 它 。 术 语 弹 
出 〈pop) 源 目 这 样 的 类 比 : 列表 就 像 一 个 栈 ， 而 删除 列表 末尾 的 
元 素 相当 于 弹出 栈 顶 元 系 。 


下 面 来 从 列表 motorcycles 中 弹出 一 款 摩托 车 : 


@ motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles) 


@ popped motorcycle = motorcycles.pop() 
@ print(motorcycles) 
@ print(popped motorcycle) 


首先 定义 并 打印 列表 motorcycles ( 见 @) 。 接 下 来 ， 从 这 个 列 
表 中 弹出 一 个 值 ， 并 将 其 赋 给 变量 popped_motorcycle 中 ( 见 
台 ) 。 人 然后 打印 这 个 列表 ， 以 核实 从 中 删除 了 一 个 值 ( 见 人 @@) 。 最 
后 打印 弹出 的 值 ， 以 证 明 我 们 依然 能 够 访问 被 删除 的 值 ( 见 @) 。 


输出 表明 ， 列 表 末 尾 的 值 'suzuki' 己 删 除 ， 它 现在 被 赋 给 了 变量 
popped motorcycle: 


['honda', 'yamaha', 'suzuki'] 
['honda', 'yamaha'] 


suzuki 


方法 pop() 有 什么 用 处 呢 ? 假设 列表 中 的 摩托 车 是 按 购 买 时 间 存 储 
的 ， 就 可 使 用 方法 pop( ) 打印 一 条 消 轧 ， 指 出 最 后 购买 的 是 哪 亚 摩 


03. 


托 车 : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 


last owned = motorcycles.pop() 


print(f"The last motorcycle I owned was a {last owned.title()}.") 


输出 是 一 个 简 蛙 的 句子 ， 指 出 了 最 新 购买 的 是 哪 球 摩 托 车 : 
TY 


弹出 列表 中 任何 位 置 处 的 元 系 


实际 上 ， 可 以 使 用 pop( ) 来 删除 列表 中 任意 位 置 的 元 素 ， 只 需 在 
括号 中 指定 要 删除 元 素 的 索引 即 可 。 


a 
风 


加 


motorcycles = ['honda', 'yamaha', 'suzuki'] 


@ first owned = motorcycles.pop(0) 


@ print(f"The first motorcycle I owned was a {first owned.title()}.") 


首先 弹出 列表 中 的 第 一 款 摩托 车 〈 见 @) ， 然 后 打印 一 条 有 关 这 辆 
摩托 车 的 消息 ( 见 @) 。 输 出 是 一 个 简单 的 句子 ， 描 述 了 我 购买 的 
第 一 辆 摩托 车 : 


The first motorcycle I owned was a Honda. 


别 生 了， 每 当 你 使 用 pop() 时 ， 被 弹出 的 元 素 就 不 再 在 列表 中 了 。 


如 果 你 不 确定 该 使 用 del 语句 还 是 pop() 方法 ， 下 面 是 一 个 简单 的 
判断 标准 : 如 果 你 要 从 列表 中 删除 一 个 元 系 ， 且 不 再 以 任何 方式 使 


04. 


用 它 ， 就 使 用 del 语句 ; 如 果 你 要 在 删除 元 素 后 还 能 继续 使 用 它 ， 
就 使 用 方法 pop() 。 
根据 值 删 除 元 素 


有 时 候 ， 你 不 知道 要 从 列表 中 删除 的 值 所 处 的 位 置 。 如 果 只 知道 要 
删除 的 元 素 的 值 ， 可 使 用 方法 remove() 。 


例如 ， 假 设 要 从 列表 motorcycles 中 删除 值 ' ducati' 。 


motorcycles = ['honda', 'yamaha', 'suzuki', 'ducati'] 
print(motorcycles) 


@ motorcycles.remove('ducati') 
print(motorcycles) 


QO 处 的 代码 让 Python 确 定 'ducati" 出 现在 列表 的 什么 地 方 ， 并 将 
该 元 素 删除 : 


['honda', 'yamaha', 'suzuki', 'ducati'] 
['honda', 'yamaha', 'suzuki'] 


使 用 remove() 从 列表 中 删除 元 系 时 ， 也 可 接着 使 用 它 的 值 。 下 面 
a 并 打印 一 条 消 轧 ， 指 出 要 将 其 从 列表 中 删除 的 原 
大 |: 


@ motorcycles = ['honda', 'yamaha', 'suzuki', 'ducati'] 
print(motorcycles) 


@ too expensive = "ducati' 


@ motorcycles.remove(too expensive) 
print(motorcycles) 
@ print(f"\nA {too expensive.title()} is too expensive for me.") 


定义 列表 ( 见 @) 后 ， 将 值 'ducati ' 赋 给 变量 too_expensive 

( 见 @) 。 接 下 来 ， 使 用 这 个 变量 来 告诉 Python 将 哪个 值 从 列表 中 
加 除 〈 见 @) 。 最 后 ， 值 'ducati' 已 经 从 列表 中 删除 ， 但 可 通过 
变量 too_expensive 来 访问 它 〈( 见 人 @) 。 这 让 我 们 能 够 打印 一 条 
消息 ， 指 出 将 "ducati' 从 列表 motorcycles 中 删除 的 原因 : 


['honda', 'yamaha', 'suzuki', 'ducati'] 
['honda', 'yamaha', 'suzuki'] 


A Ducati is too expensive for me. 


注意 ”方法 remove() 只 删除 第 一 个 指定 的 值 。 如 果 要 删除 的 
值 可 能 在 列表 中 出 现 多 次 ， 就 需要 使 用 循环 来 确保 将 每 个 值 都 
删除 。 这 将 在 第 7 章 中 介绍 。 


动手 试 一 斌 


下 面 的 练习 比 第 2 章 的 练习 要 复杂 些 ， 但 让 你 有 机 会 以 前 面 介 
绍 过 的 各 种 方式 使 用 列表 。 


练习 3-4: 过 宾 名 单 ”如 果 你 可 以 邀请 任何 人 一 起 共 进 晚餐 
(无 论 古 在 世 的 还 是 故去 的 ) ， 你 会 邀请 哪些 人 ? 请 创建 一 个 
列表 ， 其 中 包含 至 少 三 个 你 想 邀 请 的 人 ， 然 后 使 用 这 个 列表 打 
印 消 轧 ， 邀 请 这 些 人 来 与 你 共 进 晚餐 。 


练习 3-5: 修改 顷 宾 名 单 ”你 刚 得 知 有 位 天 宾 无 法 赴约 ， 因 此 


需要 另外 邀请 一 位 嘉宾 。 


。 以 完成 练习 3-4 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 
条 print 语句 ， 指 出 哪 位 嘉宾 无 法 赴约 。 

。 修改 团 宾 名 单 ， 将 无 法 赴约 的 坚 宾 的 姓名 蔡 换 为 新 邀请 的 
嘉宾 的 姓名 。 

。 再 次 打印 一 系列 消息 ， 回 名 单 中 的 每 位 如 宾 发 出 邀请 。 


练习 3-6: 生 加 过 宾 ”你 刚 找 到 了 一 个 更 大 的 餐 果 ， 可 容纳 更 


多 的 暑 宾 。 请 想 想 你 还 想 邀 请 哪 三 位 又 宾 。 


。 以 完成 练习 3-4 或 练习 3-5 时 编写 的 程序 为 基础 ， 在 程序 末 
尾 添加 一 条 print 语句 ， 指 出 你 找到 了 一 个 更 大 的 餐 果 。 

。 使 用 insert() 将 一 位 新 细 宾 添加 到 名 单 开 头 。 

。 使 用 insert() 将 另 一 位 新 里 宾 添 加 到 名 单 中 间 。 

。 使 用 append() 将 最 后 一 位 新 里 宾 添 加 到 名 单 末尾 。 

。 打印 一 系列 消息 ， 同 名 单 中 的 每 位 嘉宾 发 出 邀请 。 


练习 3-7: 缩减 名 单 ”你 刚 得 知 新 购买 的 餐 架 无 法 及 时 送 达 ， 
因此 只 能 邀请 两 位 嘉宾 。 


。 以 完成 练习 3-6 时 编写 的 程序 为 基础 ， 在 程序 末尾 添加 一 
行 代码 ， 打 印 一 条 你 只 能 邀请 两 位 嘉宾 共 进 晚餐 的 消息 。 
。 使 用 pop() 不 断 地 删除 名 单 中 的 嘉宾 ， 直 到 只 有 两 位 嘉 性 
为 止 。 每 次 从 名 单 中 弹出 一 位 嘉宾 时 ， 痢 打印 一 条 消 娠 ， 

证 该 盐 宾 知悉 你 很 抱歉 ， 无 法 邀请 他 来 共 进 晚餐 。 

。 对 于 余下 两 位 如 宾 中 的 每 一 位 ， 都 打印 一 条 消 轧 ， 指 出 他 
依然 在 受 邀 人 之 列 。 

。 使 用 del 将 最 后 两 位 嘉 性 从 名 单 中 删除 ， 让 名 单 变 成 空 
的 。 打 印 该 名 单 ， 核 实 程序 结束 时 名 单 确 实 是 空 的 。 


3.3 组 织 列 表 


在 你 创建 的 列表 中 ， 元 素 的 排列 顺序 常常 是 无 法 预测 的 ， 因 为 你 并 
非 总 能 控制 用 户 提供 数据 的 顺序 。 这 虽然 在 大 多 数 情况 下 是 不 可 各 
免 的 ， 但 你 经 种 需要 以 特定 的 顺序 呈现 信息 。 有 时 候 ， 你 而 望 保留 
列表 元 系 最 初 的 排列 顺序 ， 而 有 时 候 叉 需要 调整 排列 顺序 。Python 
提供 了 很 多 组 织 列表 的 方式 ， 可 根据 具体 情况 选用 。 


3.3.1 ”使 用 方法 sort() 对 列表 永久 排序 
Python 方法 sort() 让 你 能 够 较为 轻松 地 对 列表 进行 排序 。 假 设 你 


有 一 个 汽车 列表 ， 并 要 让 其 中 的 汽车 按 字母 顺序 排列 。 为 简化 这 项 
任务 ， 假 设 该 列表 中 的 所 有 值 都 是 小 写 的 。 


cars.py 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
@ cars.sort() 
print(cars) 


方法 sort() ( 见 @) 永久 性 地 修改 列表 元 素 的 排列 顺序 。 现 在 ， 
汽车 是 按 字 母 顺序 排列 的 ， 再 也 无 法 恢复 到 原来 的 排列 顺序 : 


['audi', 'bmw', 'subaru', "toyota ] 


还 可 以 按 与 字母 顺序 相反 的 顺序 排列 列表 元 素 ， 只 需 癌 sort() 方 
法 传递 参数 reverse=True 即 可 。 下 面 的 示例 将 汽车 列表 按 与 字母 
顺序 相反 的 顺序 排列 : 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
cars.sort(reverse=True) 
print(cars) 


同样 ， 对 列表 元 素 排 列 顺序 的 修改 是 永久 性 的 : 


['toyota', 'subaru', 'bmw', 'audi'] 


3.3.2 ”使 用 函数 sorted() 对 列表 临时 排序 

要 保留 列表 元 素 原 来 的 排列 顺序 ， 同 时 以 特定 的 顺序 呈现 它们 ， 可 
使 用 函数 sorted() 。 函 数 sorted() 让 你 能 够 按 特定 顺序 显示 列 
表 元 素 ， 同 时 不 影响 它们 在 列表 中 的 原始 排列 顺序 。 


下 面 尝 试 来 对 汽车 列表 调用 这 个 函数 。 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 


@ print("Here is the original list:") 
print(cars) 


@ print("\nHere is the sorted list:") 


print(sorted(cars)) 


@ print("\nHere is the original list again:") 
print(cars) 


首先 按 原 始 顺 序 打印 列表 ( 见 @) ， 再 按 字 母 顺 序 显示 该 列表 〈 见 
介 ) ， 以 特定 顺序 显示 列表 后 ， 我 们 进行 核实 ， 确 认 列 表 元 素 的 排 
列 顺序 与 以 前 相同 ( 见 @) 。 


Here is the original list: 
['bmw', 'audi', 'toyota', 'subaru'] 


Here is the sorted list: 
['audi', 'bmw', 'subaru', 'toyota'] 


@ Here is the original list again: 
['bmw', "audi'， 'toyota', 'subaru'] 


注意 ， 调 用 函数 sorted() 后 ， 列 表 元 素 的 排列 顺序 并 没有 变 〈 见 
四 ) 。 如 果 要 按 与 字母 顺序 相反 的 顺序 显示 列表 ， 也 可 向 函 
数 sorted() 传递 参数 reverse=True 。 


注意 ”在 并 非 所 有 的 值 都 是 小 写 时 ， 按 字母 顺序 排列 列表 要 
复杂 些 。 决 定 排 列 顺序 时 ， 有 多 种 解读 大 写字 母 的 方式 ， 要 指 
定 准确 的 排列 顺序 ， 可 能 比 我 们 这 里 所 做 的 要 复杂 。 然 而 ， 大 
多 数 排序 方式 是 以 本 节 介绍 的 知识 为 基础 的 。 


3.3.3” 倒 着 打印 列表 


要 反 转 列表 元 素 的 排列 顺序 ， 可 使 用 方法 reverse() 。 假 设 汽车 列 
表 是 按 购买 时 间 排 列 的 ， 可 轻松 地 按 相反 的 顺序 排列 其 中 的 汽车 : 


cars = ['bmw', 'audi', 'toyota', 'subaru'] 
print(cars) 


cars.reversel() 
print(cars) 


意 ，reverse() 不 是 按 与 字母 顺序 相反 的 顺序 排列 列表 元 素 ， 而 
只 是 反 转 列表 元 素 的 排列 顺序 : 


",， "audi', 'toyota', 'subaru'] 
"， "toyota', 'audi', 'bmw’'] 


方法 reverse() 永久 性 地 修改 列表 元 素 的 排列 顺序 ， 但 可 随时 恢复 
到 原来 的 排列 顺序 ， 只 需 对 列表 再 次 调用 reverse() 即 可 。 


3.3.4 确定 列表 的 长 度 


使 用 函数 len() 可 快速 获悉 列表 的 长 度 。 在 下 面 的 示例 中 ， 列 表 包 
含 四 个 元 素 ， 因 此 其 长 度 为 4 : 


>>> cars = ['bmw', 'audi', 'toyota', 'subaru'] 


>>> len(cars) 
4 


需要 完成 如 下 任务 时 ，len() 很 有 用 : 明确 还 有 多 少 个 外 星人 未 被 
射 杀 ， 而 定 需要 官 理 多 今 项 可 钢化 数据 ， 计算 网 站 有 多 少 注册 用 
户 ， 等 等 。 


注意 ”Python 计算 列表 元 素数 时 从 1 开始 ， 因 此 确定 列表 长 度 
时 ， 你 应 该 不 会 遇 到 差 一 错误 。 


动手 试 一 斌 
练习 3-8: 放眼 世界 ” 想 出 至 少 5 个 你 渴望 去 旅游 的 地 方 。 


将 这 些 地 方 存储 在 一 个 列表 中 ， 并 确保 其 中 的 元 素 不 是 按 字母 
顺序 排列 的 。 


按 原 始 排 列 顺序 打印 该 列表 。 不 要 考虑 输出 是 否 整 洁 的 问题 ， 
只 管 打印 原始 Python 列表 。 


。 顺序 打印 这 个 列表 ， 同 时 不 要 修改 


。 再 次 打印 该 列表 ， 核实 排列 顺序 未 变 。 

。 使 用 sorted() 按 与 字母 顺序 相反 的 顺序 打印 这 个 列表 ， 
同时 不 要 修改 它 。 

。 再 次 打印 该 列表 ， 核 实 排列 顺序 未 变 。 

。 使 用 reverse() 修改 列表 元 素 的 排列 顺序 。 打 印 该 列表 ， 
核实 排列 顺序 确实 变 了 。 

。 使 用 reverse() 再 次 修改 列表 元 素 的 排列 顺序 。 打 印 该 列 
表 ， 核 实 已 恢复 到 原来 的 排列 顺序 。 

。 使 用 sort() 修改 该 列表 ， 使 其 元 素 按 字母 顺序 排列 。 打 
印 该 列表 ， 核 实 排列 顺 友 确实 变 了 。 

。 使 用 sort() 修改 该 列表 ， 使 其 元 素 按 与 字母 顺序 相反 的 
顺序 排列 。 打 印 该 列表 ， 核 实 排列 顺序 确实 变 了 。 


练习 3-9: 晚餐 嘉宾 ”在 完成 练习 3-4~ 练 习 3-7 时 编写 的 程序 之 
一 中 ， 使 用 len() 打印 一 条 消息 ， 指 出 你 邀请 了 多 少 位 嘉宾 来 


共 进 晚餐 。 

练习 3-10: 尝试 使 用 各 个 函数 ” 想 想 可 存储 到 列表 中 的 东 
西 ， 如 山川 、 河 流 、 国 家 、 城 市 、 语 言 或 你 喜欢 的 任何 东西 。 
编写 一 个 程序 ， 在 其 中 创建 一 个 包含 这 些 元 素 的 列表 ， 然 后 ， 
对 于 本 章 介 绍 的 每 个 函数 ， 都 至 少 使 用 一 次 来 处 理 这 个 列表 。 


3.4 使 用 列表 时 避免 索引 错误 


刚 开 始 使 用 列表 时 ， 经 党 会 遇 到 一 种 错误 。 假 设 你 有 一 个 包含 三 个 
元 素 的 列表 ， 却 要 求 获取 第 四 个 元 素 : 


motorcycles.py 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles[3]) 


这 将 导致 索引 错误 : 


Traceback (most recent call last): 
File "motorcycles.py", line 2, in <module> 
print(motorcycles[3]) 


IndexError: list index out of range 


Python 试 图 同 你 提供 位 于 索引 3 处 的 元 系 ， 但 它 搜索 列 

表 motorcycles 时 ， 却 发 现 索 引 3 处 没有 元 素 。 鉴 于 列表 索引 差 一 
的 特征 ， 这 种 错误 很 常见 。 有 些 人 从 1 开始 数 ， 因 此 以 为 第 三 个 元 
素 的 索引 为 3。 然 而 在 Python 中 ， 第 三 个 元 系 的 索引 为 2， 因 为 索 引 
是 从 0 开始 的 。 


索引 错误 意味 着 Python 在 指定 索引 处 找 不 到 元 素 。 程 序 发 生 索 引 错 
0 然后 再 次 运行 程序 ， 看 看 结果 是 
否 正 确 。 


别 生 了， 每 当 需 要 访问 最 后 一 个 列表 元 系 时 ， 都 可 使 用 索引 -1 。 
这 在 任何 情况 下 都 行 之 有 效 ， 即 便 你 最 后 一 次 访问 列表 后 ， 其 长 度 
友和 上 生 丁 有 要 化 : 


motorcycles = ['honda', 'yamaha', 'suzuki'] 
print(motorcycles[-1]) 


| | 
索引 -1 总 是 返回 最 后 一 个 列表 元 素 ， 这 里 为 值 ' suzuki' 


"SUZUKi 


仅 当 列表 为 空 时 ， 这 种 访问 最 后 一 个 元 系 的 方式 才 会 导致 错误 : 


motorcycles = [] 
print(motorcycles[-1]) 


rd 不 包含 任何 元 素 ， 因 此 Python 返回 一 条 索引 错误 
消 忆 


Traceback (most recent call last): 
File "motorcyles.py", line 3, in <module> 
print(motorcycles[-1]) 


IndexError: list index out of range 


注意 “发生 索引 错 误 却 找 不 到 解决 办 法 时 ， 请 尝试 将 列表 或 
其 长 度 打印 出 来 。 列表 可 和 E 与 你 以 为 的 截然 不 同 ， 在 程序 对 其 
进行 了 动态 处 理 时 尤其 k 如 此 。 通过 查看 列表 或 其 包含 的 元 素 
数 ， 可 帮助 你 找 出 这 种 逻辑 错误 。 


动手 试 一 斌 


练习 3-11: 有 意 引 发 错误 ”如 果 你 还 没有 在 程序 中 过 到 过 索 
引 销 误 ， 硕 矢志 引发 一 个 这 种 钳 误 。 在 你 的 一 个 程序 中 ， 修 改 
其 中 的 索引 ， 以 引发 罕 引 错误 。 关 闭 程序 前 ， 务 必 消 除 这 个 错 


误 : 


3.5 ”小 结 


在 本 章 中 ， 你 学 习 了 : 列表 是 什么 以 及 如 何 使 用 其 中 的 元 系 ; 如何 
定义 列表 以 及 如 何 增删 元 又; 如 何 对 列表 进行 永久 性 排序 ， 以 及 如 
何 为 展示 列表 而 进行 临时 排序 ， 如 何 确定 列表 的 长 度 ， 以 及 在 使 用 
列表 时 如 何 避 免 索引 错误 。 


在 第 4 章 ， 你 将 学 习 如 何以 更 高 效 的 方式 处 理 列 表 元 率 。 通 过 使 用 
为 数 不 多 的 几 行 代码 来 贺 历 列表 元 系 ， 你 就 能 高 效 地 处 理 它 们 ， 即 
便 列表 包含 数 干 乃 至 数 百 万 个 元 系 。 


第 4 间 操作 列表 


~ 在 第 3 章 ， 你 学 习 了 如 何 创建 简单 的 列表 ， 

了 如 何 操作 列表 元 素 在 本 章 中 ， 你 将 学 习 如 何 近 历 喜 本 个 
表 ， 这 只 需要 几 行 代码 ， 无 论 列表 有 多 长 。 循 环 让 你 能 够 对 列 
表 的 每 个 元 对 都 采取 一 个 或 一 系列 相同 的 措施 ， 从 而 高 效 地 处 
理 任何 长 度 的 列表 ， 包 括 包含 数 千 力 至 数 百 万 个 元 素 的 列表 。 


4.1 过 历 整个 列表 


你 经 常 坝 要 避 历 列表 的 所 有 元 素 ， 对 每 个 元 素 执 行 相同 的 操作 。 例 
如 ， 在 游戏 中 ， 可 能 需要 将 每 个 界面 元 素平 移 相 同 的 距离 ， 对 于 包 
含 数字 的 列表 ， 可 能 需要 对 每 个 元 系 执 行 相 同 的 统计 运算 ， 在 网 站 
中 ， 可 能 需要 显示 文章 列表 中 的 每 个 标题 。 需 要 对 列表 中 的 每 个 元 
素 都 执行 相同 的 操作 时 ， 可 使 用 Python 中 的 for 循环 。 


假设 我 们 有 一 个 魔术 师 名 单 ， 需 要 将 其 中 每 个 魔术 师 的 名 字 都 打印 
出 来 。 为 此 ， 可 以 分 别 获 取 名 单 中 的 每 个 名 字 ， 但 这 种 做 法 会 导致 
多 个 问题 。 例 如 ， 如 果 名 单 很 长 ， 将 包含 大 量 重 复 的 代码 。 另 外 ， 
每 当 名 单 的 长 度 发 生变 化 时 ， 都 必须 修改 代码 。 通 过 使 用 for 循 
环 ， 可 以 让 Python 去 处 理 这 些 问 题 。 


下 面 使 用 for 循环 来 打印 魔术 师 名 单 中 的 所 有 和 名字: 


magicians.py 


@ magicians = ['alice', 'david', 'carolina'] 


@ for magician in magicians : 
3 print(magician) 


首先 ， 像 第 3 章 那 样 定 义 一 个 列表 ( 见 @) 。 接 下 来 ， 定 义 一 个 for 
循环 ( 见 @) 。 这 行 代码 让 Python 从 列表 magicians 中 取出 一 个 名 
字 ， 并 将 其 与 变量 magician 相关 联 。 最 后 ， 让 Python 打印 前 面 赋 
给 变量 magician 的 名 字 〔 见 人 @) 。 这样 ， 对 于 列表 中 的 每 个 名 
字 ，Python 都 将 重复 执行 全 处 和 全 处 的 代码 行 。 你 可 以 这 样 解读 这 
些 代码 : 对 于 列表 magicians 中 的 每 位 魔术 师 ， 都 将 其 名 字 打 印 出 
来 。 输 出 很 简单 ， 束 是 列表 中 所 有 的 名 字 : 


carolina 


4.1.1 深入 研究 循环 
循环 这 种 概念 很 重要 ， 因 为 它 是 让 计算 机 自动 完成 重复 工作 的 常见 


方式 之 一 。 例 如 ， 在 前 面 magicians.py 中 使 用 的 简单 循环 里 ，Python 
将 首先 读 取 其 中 的 第 一 行 代码 : 


for magician in magicians: 


这 行 代码 让 Python 获 取 列 表 magicians 中 的 第 一 个 值 'alice' ， 并 
将 其 与 变量 magician 相关 联 。 接 下 来 ，Python 读 取 下 一 行 代码 : 


print(magician) 


它 让 Python 打印 magician 的 值 ， 依 然 是 'alice' 。 鉴 于 该 列表 还 
包含 其 他 值 ，Python 返 回 到 循环 的 第 一 行 : 


for magician in magicians : 


Python 获取 列表 中 的 下 一 个 名 字 'david'， 并 将 其 与 变量 magician 相 关 
联 ， 再 执行 下 面 这 行 代码 : 


print(magician) 


Python 再 次 打印 变量 magician 的 值 ， 当 前 为 "david' 。 接 下 来 ， 
Python 再 次 执行 整个 循环 ， 对 列表 中 的 最 后 一 个 值 "' carolina' 进 
行 处 理 。 至 此 ， 列 表 中 没有 其 他 的 值 了 ， 因 此 Python 接着 执行 程序 
的 下 一 行 代 码 。 在 这 个 示例 中 ，for 循环 后 面 没 有 其 他 代码 ， 因 此 
程序 就 此 结束 。 


刚 开 始 使 用 循环 时 请 牢记 ， 对 列表 中 的 每 个 元 系 ， 都 将 执行 循环 指 
定 的 步 又， 而 不 管 列 表 包 售 多 少 个 元 素 。 如 果 列 表 包 合 一 百 万 个 元 


素 ，Python 就 重复 执行 指定 的 步骤 一 百 万 次 ， 且 通常 速度 非常 快 。 


另外 ， 编 写 for 循环 时 ， 可 以 给 依次 与 列表 中 每 个 值 相 关联 的 临时 
变量 指定 任意 名 称 。 然 而 ， 选 择 描述 单个 列表 元 素 的 有 意义 名 称 大 
有 神 益 。 例 如 ， 对 于 小 猫 列 表 、 小 狗 列 表 和 一 般 性 列表 ， 像 下 面 这 
样 编写 for 循环 的 第 一 行 代码 是 不 错 的 选择 : 


for cat in cats : 
for dog in dogs : 


for item in list of items : 


这 些 命 名 约定 有 助 于 你 明白 for 循环 中 将 对 每 个 元 素 执 行 的 操作 。 
使 用 单数 和 复数 式 名 称 ， 可 帮助 你 判断 代码 段 处 理 的 是 单个 列表 元 
素 还 是 整个 列表 。 


4.1.2 ”在 for 循环 中 执行 更 多 操作 


在 for 循环 中 ， 可 对 每 个 元 素 执行 任何 操作 。 下 面 来 扩展 前 面 的 示 
例 ， 对 于 每 位 魔术 师 ， 都 打印 一 条 消息 ， 指 出 他 的 表演 太 精 彩 了 。 


magicians.py 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians : 


@ print(f"{magician.title()}, that was a great trick!") 


相 比 于 前 一 个 示例 ， 唯 一 的 不 同 是 为 每 位 魔术 师 打 印 了 一 条 以 其 名 
字 为 抬头 的 消息 〈 见 @@) 。 这 个 循环 第 一 次 欠 代 时 ， 变 量 
magician 的 值 为 'alice' ， 因 此 Python 打印 的 第 一 条 消息 的 抬头 
为 'Alice' ; 第 二 次 欠 代 时 ， 消 息 的 抬头 为 "David' ; 第 三 次 迭代 
时 ， 抬 头 为 "Carolina' 。 


下 面 的 输出 表明 ， 对 于 列表 中 的 每 位 魔术 师 ， 都 打印 了 一 条 个 性 化 


消 妃 。 


Alice, that was a great trick! 
David, that was a great trick! 


Carolina, that was a great trick! 


在 for 循环 中 ， 想 包含 多 少 行 代 人 码 都 可 以 。 在 代码 行 for 
magician in magicians 后 面 ， 每 个 缩 进 的 代码 行 都 是 循环 的 一 
部 分 ， 将 针对 列表 中 的 每 个 值 都 执行 一 次 。 因 此 ， 可 对 列表 中 的 每 
个 值 执行 任意 次 数 的 操作 。 


下 面 再 添加 一 行 代码 ， 千 诉 每 位 魔术 师 ， 我 们 期 竺 他 的 下 一 次 表 


PP 和 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 
print(f"I can't wait to see your next trick, {magician.title()}. 


两 个 函数 调用 print() 都 纵 进 了 ， 因 此 它们 都 将 针对 列表 中 的 每 位 
魔术 师 执行 一 次 。 第 二 个 函数 调用 print() 中 的 换行 符 " \n”《 见 
@) 在 每 次 迫 代 结 束 后 都 插入 一 个 空 行 ， 从 而 整洁 地 将 针对 各 位 魔 
术 师 的 消 妃 编组 : 


Alice, that was a great trick! 
I can't wait to see your next trick, Alice. 


David, that was a great trick! 
I can't wait to see your next trick, David. 


Carolina, that was a great trick! 
I can't wait to see your next trick, Carolina. 


在 for 循环 中 ， 想 包含 多 少 行 代码 都 可 以 。 实 际 上 ， 你 会 发 现 使 
用 for 循环 对 每 个 元 素 执 行 众多 不 同 的 操作 很 有 用 。 


4.1.3 在 for 循环 结束 后 执行 一 些 操作 


for 循环 结束 后 怎么 办 呢 ?” 通 常 ， 你 需要 提供 总结 性 输出 或 接着 执 
行程 序 必须 完成 的 其 他 任务 。 


在 for 循环 后 面 ， 没 有 缩 进 的 代码 都 只 执行 一 次 ， 不 会 重复 执行 。 
下 面 来 打印 一 条 癌 全 体 魔 术 师 致谢 的 消 妃 ， 感 谢 他 们 的 精彩 表演 。 
想 要 在 打印 给 各 位 魔术 师 的 消息 后 面 打印 一 条 给 全 体 魔 术 师 的 致谢 
消息 ， 需 要 将 相应 的 代码 放 在 for 循环 后 面 ， 且 不 缩 进 : 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 
print(f"I can't wait to see your next trick, {magician.title()}. 


@ print("Thank you, everyone. That was a great magic show!") 


你 在 前 面 看 和 到了， 开头 两 个 函数 调用 print() 针对 列表 中 的 每 位 魔 
术 师 重复 执行 。 然 而 ， 第 三 个 函数 调用 print() 没有 缩 进 《〈 见 
@) ， 因 此 只 执行 一 次 : 


Alice, that was a great trick! 
I can't wait to see your next trick, Alice. 


David, that was a great trick! 
I can't wait to see your next trick, David. 


Carolina, that was a great trick! 
I can't wait to see your next trick, Carolina. 


Thank you, everyone. That was a great magic show! 


使 用 for 循环 处 理 数据 是 一 种 对 数据 集 执行 整体 操作 的 不 错 方 式 。 
例如 ， 你 可 能 使 用 for 循环 来 初始 化 游戏 : 遍历 角色 列表 ， 将 每 个 
角色 显示 到 屏幕 上 。 人 然后 在 循环 后 面 添加 一 个 不 缩 进 的 代码 块 ， 在 
屏幕 上 绘制 所 有 角色 后 显示 一 个 Play Now 按 钮 。 


4.2 ”避免 缩 进 错误 


Python 根据 缩 进来 判断 代码 行 与 前 一 个 代码 行 的 关系 。 在 前 面 的 示 
例 中 ， 回 各 位 魔术 师 显示 消 妃 的 代码 行 是 for 循环 的 一 部 分 ， 因 为 
它们 缩 进 了 。Python 通 过 使 用 缩 进 让 代码 更 易 读 。 简 单 地 说 ， 它 要 
求 你 使 用 缩 进 让 代码 整洁 而 结构 清晰 。 在 较 长 的 Python 程序 中 ， 你 
和 
J] 认识。 


开始 编写 必须 正确 缩 进 的 代码 时 ， 需 要 注意 一 些 常 见 的 缩 进 错误 
。 例 如 ， 程 序 员 有 时 候 会 将 不 需要 缩 进 的 代码 块 缩 进 ， 而 对 于 必须 
缩 进 的 代码 块 却 筷 了 缩 进 。 碍 看 这 样 的 错误 示例 有 助 于 你 以 后 避 开 
它们 ， 以 及 在 它们 出 现在 程序 中 时 进行 修复 。 


下 面 来 看 一 些 较为 常见 的 缩 进 错误 。 


4.2.1 ”忘记 缩 进 


进 。 如 果 忘 记 缩 进 ， Python 会 提醒 你 : 


magicians.py 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 


@ print(magician) 


函数 调用 print() 〈 见 @) 应 缩 进 却 没 有 缩 进 。Python 没 有 找到 期 
望 缩 进 的 代码 块 时 ， 会 让 你 知道 哪 行 代 码 有 问题 。 


File "magicians.py", line 3 
print(magician) 
八 


IndentationError: expected an indented block 


通 稍 ， 将 紧 跟 在 for 语句 后 面 的 代码 行 缩 进 ， 可 消除 这 种 缩 进 错 
误 。 

4.2.2 ”未 记 缩 进 额外 的 代码 行 

有 时 候 ， 循 环 能 够 运行 且 不 会 报告 错误 ， 但 结果 可 能 出 人 意料 。 试 
图 在 循环 中 执行 多 项 任务 ， 却 忘记 缩 进 其 中 的 一 些 代 人 码 行 时 ， 就 会 
出 现 这 种 情况 。 


例如 ， 如 果 忘 记 缩 进 循环 中 的 第 二 行 代码 〈 它 告诉 每 位 魔术 师 ， 我 
们 期 待 其 下 次 表演 ) ， 就 会 出 现 这 种 情况 : 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians : 
print(f"{magician.title()}, that was a great trick!") 


@ print(f"I can't wait to see your next trick, {magician.title()}.\n") 


第 二 个 函数 调用 print() 〈 见 @) 原本 需要 缩 进 ， 但 Python 发 现 
for 语句 后 面 有 一 行 代码 是 缩 进 的 ， 因 此 没有 报告 错误 。 最 终 的 结 
末 是 ， 对 于 列表 中 的 每 位 魔术 师 ， 都 执行 了 第 一 个 函数 调 

用 print() ， 因 为 它 缩 进 了 ; 而 第 二 个 函数 调用 print() 没有 缩 
进 ， 因 此 只 在 循环 结束 后 执行 一 次 。 由 于 变量 magician 的 终 值 
为 'carolina' ， 结 果 只 有 她 收 到 了 消息 "looking forward to the next 
trick”: 


Alice, that was a great trick! 
David, that was a great trick! 
Carolina, that was a great trick! 


I can't wait to see your next trick, Carolina. 


这 是 一 个 馆 辑 错误 。 从 语法 上 看 ， 这 些 Python 代 码 是 合法 的 ， 但 由 
于 存在 远 辑 错误 ， 结 果 并 不 符合 预期 。 如 果 你 预期 某 项 操作 将 针对 
每 个 列表 元 素 都 执行 一 次 ， 但 它 总 共 只 执行 了 一 次 ， 请 确定 需要 将 
一 行 还 是 多 行 代码 缩 进 。 


4.2.3 不 必要 的 缩 进 
如 果 你 不 小 心 缩 进 了 无 须 缩 进 的 代码 行 ，Python 将 指出 这 一 
hello_world.py 


message = "Hello Python world!" 
@ print(message) 


函数 调用 print() 《( 见 @) 无 须 缩 进 ， 因 为 它 并 非 循环 的 组 成 部 
分 。 因 此 Python 将 指出 这 种 错误 : 


File "hello world.py", line 2 


print(message) 


IndentationError: unexpected indent 


为 避免 意外 缩 进 错误 ， 请 只 缩 进 需要 缩 进 的 代码 。 在 前 面 编 写 的 程 
序 中 ， 只 有 要 在 for 循环 中 对 每 个 元 素 执行 的 代码 需要 缩 进 ， 


4.2.4 循环 后 不 必要 的 缩 进 

如 果 不 小 心 缩 进 了 应 在 循环 结束 后 执行 的 代码 ， 这 些 代 码 将 针对 每 
在 有 些 情况 下 ， 这 可 外 导致 python 报 告 语法 
错误 ， 但 在 大 多 数 情 况 下 ， 这 只 会 导致 逻辑 错误 。 


例如 ， 如 果 不 小 心 缩 进 了 感谢 全 体 魔术 师 精 彩 表演 的 代码 行 ， 结 果 
将 如 何 呢 ? 


magicians.py 


magicians = ['alice', 'david', 'carolina'] 
for magician in magicians: 
print(f"{magician.title()}, that was a great trick!") 


print(f"I can't wait to see your next trick, {magician.title()}. 


@ print("Thank you everyone, that was a great magic show!") 


由 于 人 @ 处 的 代码 行 缩 进 了 ， 它 将 针对 列表 中 的 每 位 魔术 师 执行 一 
次 ， 如 下 所 示 : 


Alice, that was a great trick! 
I can't wait to see your next trick, Alice. 


Thank you everyone, that was a great magic show! 
David, that was a great trick! 
I can't wait to see your next trick, David. 


Thank you everyone, that was a great magic show! 
Carolina, that was a great trick! 
I can't wait to see your next trick, Carolina. 


Thank you everyone, that was a great magic show! 


这 也 是 一 个 逻辑 错误 ， 与 4.2.2 节 的 错误 类 似 。Python 不 知道 你 的 本 
意 ， 只 要 代码 符合 语法 ， 它 就 会 运行 。 如 末 原 本 只 应 执行 一 次 的 操 
作 执 行 了 多 次 ， 可 能 要 对 执行 该 操作 的 代码 取消 缩 进 。 


4.2.5 ”遗漏 了 冒号 
for 语句 末尾 的 冒号 告诉 Python， 下 一 行 是 循环 的 第 一 行 。 


magicians = ['alice', 'david', 'carolina'] 
@ for magician in magicians 


print(magician) 


如 果 不 小 心 遗漏 了 冒号 ， 如 人 @ 所 示 ， 将 导致 语法 错误 ， 因 为 Python 
不 知道 你 意欲 何 为 。 这 种 错误 虽然 易于 消除 ， 但 并 不 那么 容易 发 
现 。 程 序 员 为 找 出 这 样 的 单字 符 错 误 ， 花 费 的 时 间 多 得 令 人 惊讶 。 
此 类 错误 之 所 以 难以 发 现 ， 是 因为 通常 在 人 们 的 意料 之 外 。 


动手 试 一 斌 


练习 4-1: 比 辽 ” 想 出 至 少 三 种 你 喜欢 的 比 阵 ， 将 其 名 称 存 储 
在 一 个 列表 中 ， 再 使 用 for 循环 将 每 种 比 辽 的 名 称 打印 出 来 。 


。 修改 这 个 for 循环 ， 使 其 打印 包含 比 院 名 称 的 句子 ， 而 不 
仅仅 是 比 陡 的 名 称 。 对 于 每 种 比 工 ， 都 显示 一 行 输出 ， 下 
面 是 一 个 例子 。 


I like pepperoni pizza. 


。 在 程序 末尾 添加 一 行 代码 ， 它 不 在 for 循环 中 ， 指 出 你 有 
多 喜欢 比 吐 。 输 出 应 包含 针对 每 种 比 蔷 的 消息 ， 还 有 一 个 
总 结 性 句子 ， 下 面 是 一 个 例子 。 


Ireally love pizzal 


练习 4-2: 动物 ” 想 出 至 少 三 种 有 共同 特征 的 动物 ， 将 其 名 称 
0 


。 修改 这 个 程序 ， 使 其 针对 每 种 动物 都 打印 一 个 句子 ， 下 面 
是 一 个 例子 。 


A dog would make a great pet. 


。 在 程序 末尾 添加 一 行 代码 ， 指 出 这 些 动物 的 共同 之 处 ， 如 
打印 下 面 这 样 的 句子 。 


Any of these animals would make a great pet! 


4.3 ”创建 数值 列表 


需要 存储 一 组 数 的 原因 有 很 多 。 例 如 ， 在 游戏 中 ， 需 要 跟踪 每 个 角 
色 的 位 置 ， 还 可 能 需要 跟踪 玩家 的 几 个 最 高 得 分 ， 在 数据 可 视 化 

中 ， 处 理 的 几乎 都 是 由 数 〈 如 温度 、 距 离 、 人 口 数量 、 经 度 和 纬度 
等 ) 组 成 的 集合 。 


列表 非常 适合 用 于 存储 数字 集合 ， 而 Python 提供 了 很 多 工具 ， 可 大 
助 你 高 效 地 处 理 数 字 列 表 。 明 和 白 如 何 有 效 地 使 用 这 些 工具 后 ， 即 便 
列表 包含 数 百 万 个 元 素 ， 你 编写 的 代码 也 能 运行 得 很 好 。 

4.3.1 ”使 用 函数 range() 


Python 函数 range() 让 你 能 够 轻松 地 生成 一 系列 数 。 例 如 ， 可 以 像 
下 面 这 样 使 用 函数 range() 来 打印 一 系列 数 : 


first_numbers.py 


for value in range(1, 5): 
print(value) 


上 述 代码 好 像 应 该 打印 数 1~~5， 但 实际 上 不 会 打印 5: 


UWODPp 


在 这 个 示例 中 ，range() 只 打印 数 1~~4。 这 是 编程 语言 中 常见 的 差 
一 行为 的 结果 。 函 数 range() 让 Python 从 指定 的 第 一 个 值 开 始 数 ， 
并 在 到 达 你 指定 的 第 二 个 值 时 停止 。 因 为 它 在 第 二 个 值 处 停止 ， 所 
以 输出 不 包含 该 值 ( 这 里 为 5)。 


要 打印 数 1~~5， 需 要 使 用 range(1,6): 


for value in range(1, 6): 
print(value) 


这 样 ， 输 出 将 从 1 开始 、 到 5 结束 : 


多 


， range() 时 ， 如 果 输 出 不 符合 预期 ， 请 尝试 将 指定 的 值 加 1 或 
妒 :1。 


调用 函数 range() 时 ， 也 可 只 指定 一 个 参数 ， 这 样 它 将 从 0 开始 。 
例如 ，range(6) 返回 数 0 一 5。 


4.3.2 ”使 用 range() 创建 数字 列表 

要 创建 数字 列表 ， 可 使 用 函数 1ist() 将 range() 的 结果 直接 转换 
J 如 果 将 range() 作为 1ist() 的 参数 ， 输 出 将 是 一 个 数字 
列表 。 


在 前 一 节 的 示例 中 ， 只 是 将 一 系列 数 打 印 出 来 。 要 将 这 组 数 转换 为 
列表 ， 可 使 用 1ist() : 


numbers = list(range(1, 6)) 
print(numbers) 


使 用 函数 range() 时 ， 还 可 指定 步 长 。 为 此 ， 可 给 这 个 函数 指定 第 
三 个 参数 ，Python 将 根据 这 个 步 长 来 生成 数 。 


例如 ， 下 面 的 代码 打印 1 一 10 的 偶数 : 


even_numbers.py 


even_numbers = list(range(2, 11, 2)) 
print(even numbers) 


在 这 个 示例 中 ， 函 数 range() 从 2 开始 数 ， 然 后 不 断 加 2， 直 到 达到 
或 超过 终 值 (11) ， 因 此 输出 如 下 : 


[2，4，6，8，196] 


使 用 函数 range() 几乎 能 够 创建 任何 需要 的 数 集 。 例 如 ， 如 何 创建 
一 个 列表 ， 其 中 包含 前 10 个 整数 (1 一 10) 的 平方 昵 ? 在 Python 
中 ， 用 两 个 星 号 (** ) 表示 乘 方 运算 。 下 面 的 代码 演示 了 如 何 将 
前 10 个 整数 的 平方 加 入 一 个 列表 中 : 


Squares.py 


@ squares = [|] 

@ for value in range(1, 11): 
日 Square = Value ** 2 

@ squares .append(square) 


© print(squares) 


首先 ， 创 建 一 个 名 为 squares 的 空 列表 ( 见 @)， , 接 下 来 ,使 用 巴 
数 range() 让 Python 遍历 1 一 10 的 值 〈 见 贸 ) 。 在 循环 中 ， 计 算 当 
前 值 的 平方 ， 并 将 结果 赋 给 变量 square ( 见 @) 。 然 后 ， 将 新 计 
算得 到 的 平方 值 附加 到 列表 squares 末尾 ( 见 @) 。 最 后 ， 循 环 结 
束 后 ， 打 印 列表 squares 〈 见 加 ) : 


[1，4，9，16，25，36，49，64，81，169] 


为 了 让 代码 更 简洁 ， 可 不 使 用 临时 变量 square ， 而 直接 将 每 个 计 
算得 到 的 值 附加 到 列表 末尾， 


squares = [] 
for value in range(1,11) : 
@ squares.append(value**2) 


print(squares) 


@ 处 的 代码 与 squares.py 中 全 处 和 @ 处 的 代码 等 效 。 在 循环 中 ， 计 
算 每 个 值 的 平方 ， 并 立即 将 结果 附加 到 列表 squares 的 末尾 。 


创建 更 复杂 的 列表 时 ， 可 使 用 上 述 两 种 方法 中 的 任何 一 种 。 有 时 
候 ， 使 用 临时 变量 会 让 代码 更 易 读 ， 而 在 其 他 情况 下 ， 这 样 做 只 会 
让 代码 无 谓 地 变 长 。 你 首先 应 该 考虑 的 是 ， 编 写 清晰 易 懂 且 能 完成 
所 需 功能 的 代码 ， 等 到 审核 代码 时 ， 再 考虑 采用 更 高 效 的 方法 。 


4.3.3 ”对 数字 列表 执行 简单 的 统计 计算 


有 几 个 专门 用 于 处 理 数 字 列 表 的 Python 函数 。 例 如 ， 你 可 以 轻松 地 
找 出 数字 列表 的 最 大 值 、 最 小 值 和 总 和 : 


>>> digits = [1, 2, 3, 4, 5, 6, 7, 8, 9, 0] 
>>> min(digits) 

0 

>>> max(digits) 

9 


>>> sum(digits) 
45 


注音 ”考虑 到 版 钾 ， 本 市 使 用 的 数字 列表 都 很 短 ， 但 这 里 介 
绍 的 知识 也 适用 于 包含 数 百 万 个 数 的 列表 。 


4.3.4 列表 解析 


前 面 介绍 的 生成 列表 squares 的 方式 包含 三 四 行 代码 ， 而 列表 解析 
让 你 只 需 编写 一 行 代码 就 能 生成 这 样 的 列表 。 列 表 解 析 将 for 循 
环 和 创建 新 元 素 的 代码 合并 成 一 行 ， 并 自动 附加 新 元 素 。 面 癌 初 学 
者 的 书 并 非 都 会 介绍 列表 解析 ， 这 里 之 所 以 介绍 列表 解析 ， 是 因为 
等 你 开始 阅读 他 人 编写 的 代码 时 ， 很 可 能 会 遇 到 它 。 


下 面 的 示例 使 用 列表 解析 创建 你 在 前 面 看 到 的 平方 数列 表 : 


SqUares.py 


squares = [value**2 for value in range(1, 11)] 
print(squares) 


要 使 用 这 种 语法 ， 首 先 指定 一 个 描述 性 的 列表 名 ， 如 squares 。 然 
后 ， 指 定 一 个 左 方 括号 ， 并 定义 一 个 表达 式 ， 用 于 生成 要 存储 到 列 
表 中 的 值 。 在 这 个 示例 中 ， 表 达 式 为 value**2 ， 它 计算 平方 值 。 
接 下 来 ， 编 写 一 个 for 循环 ， 用 于 给 表达 式 提供 值 ， 再 加 上 右 方 括 
号 。 在 这 个 示例 中 ，for 循环 为 for value in range(1,11) ， 
它 将 值 1 一 10 提 供给 表达 式 value*x*2 。 请 注意 ， 这 里 的 for 语句 末 
尾 没 有 冒号 。 


结果 与 前 面 的 平方 数列 表 相 同 : 


[1, 4, 9, 16, 25, 36, 49, 64, 81, 160] 


要 创建 自己 的 列表 解析 ， 需 要 经 过 一 定 的 练习 ， 但 能 够 熟练 地 创建 
常规 列表 后 ， 你 会 发 现 这 样 做 是 完全 值得 的 。 当 你 觉得 编写 三 四 行 
代码 来 生成 列表 有 点 繁复 时 ， 就 应 考虑 创建 列表 解析 了 。 
动手 试 一 试 

练习 4-3: 数 到 20 使 用 一 个 for 循环 打印 数 1 一 20 〈 含 ) 。 


练习 4-4: 一 百 万 ”创建 一 个 包含 数 1~1 000 000 的 列表 ， 再 使 
用 一 个 for 循环 将 这 些 数 打印 出 来 。《〈 如 果 输 出 的 时 间 太 长 ， 
按 Ctrl + C 停 止 输出 或 关闭 输出 窗口 。) 


练习 4-5: 一 百 万 求 和 创建 一 个 包含 数 1 一 1 000 000 的 列 
表 ， 再 使 用 min() 和 max() 核实 该 列表 确实 是 从 1 开始 、 到 1 
000 000 结 束 的 。 另 外 ， 对 这 个 列表 调用 函数 sum() ， 看 看 
Python 将 一 百 万 个 数 相 加 需要 多 长 时 间 。 


练习 4-6: 奇数 ”通过 给 函数 range() 指定 第 三 个 参数 来 创建 
一 个 列表 ， 其 中 包含 1 一 20 的 奇数 ， 再 使 用 一 个 for 循环 将 这 
些 数 打 印 出 来 。 


练习 4-7: 3 的 倍数 ”创建 一 个 列表 ， 其 中 包 舍 3 一 30 能 被 3 整除 
的 数 ， 再 使 用 一 个 for 循环 将 这 个 列表 中 的 数 打印 出 来 。 


练习 4-8: 立方 ”将 同一 个 数 乘 三 次 称 为 立方 。 例 如 ， 在 
Python 中 ，2 的 立方 用 2**#3 表示 。 请 创建 一 个 列表 ， 其 中 包含 
前 10 个 整数 〈1 一 10) 的 立方 ， 再 使 用 一 个 for 循环 将 这 些 立 
方 数 打印 出 来 。 


练习 4-9: 立方 解析 ”使 用 列表 解析 生成 一 个 列表 ， 其 中 包含 
前 10 个 整数 的 立方 。 


4.4 使 用 列表 的 一 部 分 


在 第 3 章 中 ， 你 学 习 了 如 何 访问 单个 列表 元 素 。 在 本 章 中 ， 你 一 直 
在 学 习 如 何 处 理 列 表 的 所 有 元 素 。 你 还 可 以 处 理 列 表 的 部 分 元 素 ， 
Python 称 之 为 切片 。 


4.4.1 切片 

要 创建 切片 ， 可 指定 要 使 用 的 第 一 个 元 素 和 最 后 一 个 元 素 的 索引 。 
与 函数 range() 一 样 ，Python 在 到 达 第 二 个 索引 之 前 的 元 素 后 停 
止 。 要 输出 列表 中 的 前 三 个 元 素 ， 需 要 指定 索引 0 和 3， 这 将 返回 索 
引 为 0、1 和 2 的 元 素 。 


下 面 的 示例 处 理 的 是 一 个 运动 队 成 员 列 表 : 


players.py 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
@ print(players[6:3]) 


@@ 处 的 代码 打印 该 列表 的 一 个 切片 ， 其 中 只 包含 三 名 队员 。 输 出 也 
古 一 个 列表 ， 其 中 包含 前 三 名 队员 : 


['charles', 'martina', 'michael'] 


你 可 以 生成 列表 的 任意 子 集 。 例 如 ， 如 果 要 提取 列表 的 第 二 、 第 三 
和 第 四 个 元 系 ， 可 将 起 始 索 引 指 定 为 1 ， 并 将 终止 索引 指定 为 4 : 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
print(players[1:4]) 


此 时 ， 切 片 始 于 'martina' 、 终 于 'florence'。 


['martina', 'michael', 'florence'] 


如 果 没 有 指定 第 一 个 索引 ，Python 将 自动 从 列表 开头 开始 : 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
print(players[:4]) 


由 于 没有 指定 起 始 索引 ，Python 从 列表 开头 开始 提取 : 


['charles', 'martina', 'michael', "florence '] 


要 让 切片 终止 于 列表 末尾 ， 也 可 使 用 类 似 的 语法 。 例 如 ， 如 果 要 所 
取 从 第 三 个 元 系 到 列表 末尾 的 所 有 元 系 ， 可 将 起 始 索 引 指定 为 2 ， 
并 省 略 终 止 索引 : 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
print(players[2:]) 


Python 将 返回 从 第 三 个 元 素 到 列表 末尾 的 所 有 元 素 : 


['michael', 'florence', "eli'] 


无 论 列表 多 长 ， 这 种 语法 都 能 够 让 你 输出 从 特定 位 置 到 列表 末尾 的 
所 有 元 素 。 上 一 章 说 过 ， 负 数 索 引 返 回 离 列 表 末 尾 相 应 距离 的 元 
素 ， 因 此 你 可 以 输出 列表 末尾 的 任意 切片 。 例 如 ， 如 果 要 输出 名 单 
上 的 最 后 三 名 队员 ， 可 使 用 切片 players[-3:] : 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
print(players[-3:]) 


[L | 


上 述 代码 打印 最 后 三 名 队员 的 名 字 ， 即 便 队 员 名 单 长 度 发 生变 化 ， 
也 依然 如 此 。 


注意 ”可 在 表示 切片 的 方 括号 内 指定 第 三 个 值 。 这 个 值 告诉 
Python 在 指定 范围 内 每 隔 多 少 元 素 提取 一 个 。 


4.4.2 ” 裔 历 切 片 


如 果 要 人 过 历 列表 的 部 分 元 素 ， 可 在 for 循环 中 使 用 切片 。 下 面 的 示 
例 志 历 前 三 名 队员 ， 并 打印 他 们 的 名 他: 


players = ['charles', 'martina', 'michael', 'florence', 'eli'] 


print("Here are the first three players on my team:") 


@ for player in players[:3]: 
print(player.title()) 


和 四 处 的 代码 没有 通 历 整 个 队员 列表 ， 而 只 遍历 前 三 名 队员 : 


Here are the first three players on my team: 


在 很 多 情况 下 ， 切 片 都 很 有 用 。 例 如 ， 编 写 游戏 时 ， 你 可 以 在 玩家 


退出 游戏 时 将 其 最 终 得 分 加 入 一 个 列表 中 ， 然 后 将 该 列表 按 降 序 排 
列 以 获取 三 个 最 高 得 分 ， 再 创建 一 个 只 包含 前 三 个 得 分 的 切片 ;处 
理 数据 时 ， 可 使 用 切片 来 进行 批量 处 理 ， 编 写 Web 应 用 程序 时 ， 可 
使 用 切片 来 分 页 显示 信息 ， 并 在 每 页 显示 数量 合适 的 信息 。 


4.4.3 复制 列表 


我 们 经 党 需要 根据 既 有 列表 创建 全 新 的 列表 。 下 面 来 介绍 复制 列表 
的 工作 原理 ， 以 及 复制 列表 可 提供 极 大 帮助 的 一 种 情形 。 


要 复制 列表 ， 可 创建 一 个 包含 整个 列表 的 切片 ， 方 法 是 同时 省 略 起 
始 索 引 和 终止 索引 《〈[:] ) 。 这 让 Python 创建 一 个 始 于 第 一 个 元 
素 、 终 止 于 最 后 一 个 元 素 的 切片 ， 即 整个 列表 的 副本 。 


例如 ， 假 设 有 一 个 列表 包含 你 最 辟 欢 的 四 种 食品 ， 而 你 想 再 创建 一 
个 列表 ， 并 在 其 中 包含 一 位 朋友 喜欢 的 所 有 食品 。 不 过 ， 你 喜欢 的 
食品 ， 这 位 朋友 也 都 喜欢 ， 因 此 可 通过 复制 来 创建 这 个 列表 : 


foods.py 


@ my foods = ['pizza', 'falafel', 'carrot cake'] 
@ friend foods = my_foods[:] 


print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 
print(friend foods) 


首先 ， 创 建 一 个 你 喜欢 的 食品 列表 ， 名 为 my_foods ( 见 @) 。 然 
后 创建 一 个 名 为 friend_foods 的 新 列表 ( 见 @) 。 在 不 指 SS 
索引 的 情况 下 从 列表 my_foods 中 提取 一 个 切片 ， 从 而 创建 这 个 列 
表 的 副本 ， 并 将 该 副本 赋 给 变量 friend_ foods 。 打 印 这 两 个 列表 
后 ， 我 们 发 现 其 包含 的 食品 相同 : 


My favorite foods are: 
['pizza', 'falafel', 'carrot cake'] 


My friend's favorite foods are: 
['pizza', 'falafel', 'carrot cake'] 


为 核实 确实 有 两 个 列表 ， 下 面 在 每 个 列表 中 都 添加 一 种 食品 ， 并 核 
实 每 个 列表 都 记录 了 相应 人 员 喜 欢 的 食品 : 


my_foods = ['pizza', 'falafel', 'carrot cake'] 
@ friend foods = my_foods[:] 


@ my_foods.append('cannoli') 
@ friend foods.append('ice cream') 


print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 
print(friend foods) 


与 前 一 个 示例 一 样 ， 首 先 将 my_foods 的 元 素 复 制 到 新 列 

表 friend_ foods 中 ( 见 @) 。 接 下 来 ， 在 每 个 列表 中 都 添加 一 种 
食品 : 在 列表 my_foods 中 添加 'cannoli' ( 见 信 ) ， 而 

在 friend_ foods 中 添加 'ice cream' ( 见 @) 。 最后， 打印 这 两 
个 列表 ， 核 实 这 两 种 食品 分 别 包含 在 正确 的 列表 中 。 


My favorite foods are: 
@ ['pizza', 'falafel', 'carrot cake', 'cannoli'] 


My friend's favorite foods are: 
© ['pizza', 'falafel', 'carrot cake', 'ice cream'| 


四 处 的 输出 表明 ， 'cannoli' 包含 在 你 喜欢 的 食品 列表 中 ， 

而 'ice cream' 不 在 。 人 @ 处 的 输出 表明 ，'ice cream' 包含 在 你 
朋友 喜欢 的 食品 列表 中 ， 而 'cannoli' 不 在 。 如 果 只 是 

将 my_foods 赋 给 friend_foods ， 就 不 能 得 到 两 个 列表 。 例 如 ， 
下 面 演示 了 在 不 使 用 切片 的 情况 下 复制 列表 的 情况 : 


my_foods = ['pizza', 'falafel', "carrot cake'] 


# 这 行 不 通 : 
@ friend foods = my_foods 


my_foods.append('cannoli') 
friend foods.append('ice cream') 


print("My favorite foods are:") 
print(my_foods) 


print("\nMy friend's favorite foods are:") 


print(friend foods ) 


这 里 将 my_foods 赋 给 friend_foods ， 而 不 是 将 my_foods 的 副本 
赋 给 friend_foods ( 见 @) 。 这 种 语法 实际 上 是 让 Python 将 新 变 
量 friend_foods 关联 到 已 与 my_foods 相关 联 的 列表 ， 因 此 这 两 
个 变量 指 阿 同一 个 列表 。 有 鉴于 此 ， 当 我 们 将 "cannoli' 添加 

到 my_foods 中 时 ， 它 也 将 出 现在 friend_foods 中 。 同 样 ， 虽 
然 'ice cream' 好 像 只 被 加 入 到 了 friend_foods 中 ， 但 它 也 将 出 
现在 这 两 个 列表 中 。 


输出 表明 ， 两 个 列表 是 相同 的 ， 这 并 非 我 们 想 要 的 结果 : 


My favorite foods are : 
['pizza', 'falafel', 'carrot cake', "cannoli'， "ice cream '] 


My friend's favorite foods are: 


['pizza', 'falafel', 'carrot cake', "cannoli'， "ice cream '] 


注意 ”暂时 不 要 考虑 这 个 示例 中 的 细节 。 当 试图 使 用 列表 的 
副本 时 结果 出 卑 意料 ， 基 本 上 都 要 确认 你 是 人 否 像 第 一 个 示例 那 
样 使 用 切片 复制 了 列表 。 
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练习 4-10: 切片 ”选择 你 在 本 章 编 写 的 一 个 程序 ， 在 末尾 添加 
儿 行 代码 ， 以 完成 如 下 任务 。 


。 打印 消息 “The first three items in the list are:”， 再 使 用 切片 
来 打印 列表 的 前 三 个 元 素 。 

。 打印 消息 “Three items from the middle of the list are:”， 再 使 
用 切片 来 打印 列表 的 中 间 三 个 元 素 。 

。 打印 消息 “The last three items in the list are:”， 再 使 用 切片 
来 打印 列表 的 末尾 三 个 元 素 。 


练习 4-11: 你 的 比萨 ， 我 的 比萨 ”在 你 为 完成 练习 4-1 而 编写 
的 程序 中 ， 创 建 比 院 列 表 的 副本 ， 并 将 其 赋 给 变量 
friend_pizzas ， 再 完成 如 下 任务 。 


。 在 原来 的 比萨 列表 中 添加 一 种 比 院 。 

。 在 列表 friend_pizzas 中 添加 另 一 种 比萨 。 

。 核实 有 两 个 不 同 的 列表 。 为 此 ， 打 印 消息 *My favorite 
pizzas are:”， 再 使 用 一 个 for 循环 来 打印 第 一 个 列表 ; 打 
印 消息 <*My friend's favorite pizzas are:”， 再 使 用 一 个 for 


人 循环 来 打印 第 二 个 列表 。 核 实 新 增 的 比 酝 被 添加 到 了 正确 
的 列表 中 。 


练习 4-12: 使 用 多 个 循环 ”在 本 节 中 ， 为 市 省 篇 幅 ， 程 厅 
foods.py 的 每 个 版 本 都 没有 使 用 for 循环 来 打印 列表 。 请 选择 


一 个 版 本 的 foods.py， 在 其 中 编写 两 个 for 循环 ， 将 各 个 食品 
列表 打印 出 来 。 


4.5 ”元 组 


列表 非常 适合 用 于 存储 在 程序 运行 期 间 可 能 变化 的 数据 集 。 列 表 是 
可 以 修改 的 ， 这 对 处 理 网 站 的 用 户 列 表 或 游戏 中 的 角色 列表 至 关 重 
要 。 然 而 ， 有 时 候 你 需要 创建 一 系列 不 可 修改 的 元 素 ， 元 组 可 以 满 
足 这 种 需求 。Python 将 不 能 修改 的 值 称 为 不 可 变 的 ， 而 不 可 变 的 列 
表 被 称 为 元 组 。 


4.5.1 定义 元 组 


元 组 看 起 来 很 像 列表 ， 但 使 用 圆 括 与 而 非 中 括 写 来 标识 。 定 义 元 组 
后 ， 就 可 使 用 索引 来 访问 其 元 系 ， 束 像 访 问 列表 元 素 一 样 。 


例如 ， 如 果 有 一 个 大 小 不 应 改变 的 矩形 ， 可 将 其 长 度 和 宽度 存储 在 
一 个 元 组 中 ， 从 而 确保 它们 是 不 能 修改 的 : 


dimensions.py 


@ dimensions = (206，56) 
@ print(dimensions[6]) 


print(dimensions[1]) 


首先 定义 元 组 dimensions ( 见 @) ， 为 此 使 用 了 圆 括号 而 不 是 方 
括号 。 接 下 来 ， 分 别 打印 该 元 组 的 各 个 元 素 ， 使 用 的 语法 与 访问 列 
表 元 素 时 使 用 的 语法 相同 ( 见 @) : 


2060 
50 


下 面 来 尝试 修改 元 组 dimensions 的 一 个 元 素 ， 看 看 结果 如 何 : 


dimensions = (260，50) 
@ dimensions[6] = 256 


| 


@@ 处 的 代码 试图 修改 第 一 个 元 素 的 值 ， 导 致 Python 返 回 类 型 错误 消 
晨 。 由 于 试图 修改 元 组 的 操作 是 被 茶 止 的 ， 因 此 Python 指 出 不 能 给 
元 组 的 元 素 赋 值 : 


Traceback (most recent call last): 
File "dimensions.py", line 2, in <module> 
dimensions[6] = 256 


TypeError: 'tuple' object does not support :item assignment 


这 很 好 ， 因为 我 们 希望 Python 在 代码 试图 修改 矩形 的 尺寸 时 引发 错 
误 。 
注意 I 元 组 是 由 辟 写 标识 的 ， 圆 括号 只 是 让 元 组 


看 起 来 更 整洁 、 更 清晰 。 如 果 你 要 定义 只 包含 一 个 元 素 的 元 
组 ， 必 须 在 这 个 元 素 后 面 加 上 号 


创建 只 包含 一 个 元 系 的 元 组 通常 没有 意义 ， 但 自动 生成 的 元 组 
有 可 能 只 有 一 个 元 素 。 


4.5.2 ”遍历 元 组 中 的 所 有 值 
像 列表 一 样 ， 也 可 以 使 用 for 循环 来 壳 历 元 组 中 的 所 有 值 : 


dimensions = (209，50) 
for dimension in dimensions : 


print(dimension) 


就 像 遍 历 列表 时 一 样 ，Python 返 回 元 组 中 所 有 的 元 素 : 


260 


”| 
4.5.3 ”修改 元 组 变量 


虽然 不 能 修改 元 组 的 元 素 ， 但 可 以 给 存储 元 组 的 变量 赋值 。 因 此 ， 
如 琳 要 修改 前 述 窍 形 的 尺寸 ， 可 重新 定义 整个 元 组 : 


@ dimensions = (260，506) 
print("Original dimensions:") 
for dimension in dimensions: 

print(dimension) 


@ dimensions = (4606, 1060) 
@ print("\nModified dimensions:") 
for dimension in dimensions: 
print(dimension) 


首先 定义 一 个 元 组 ， 并 将 其 存储 的 尺寸 打印 出 来 ( 见 @)， 。 接 下 
来 ， 将 一 个 新 元 组 关联 到 变量 dimensions ( 见 @) 。 然 后 ， 打 印 
新 的 尺寸 ( 见 @) 。 这 次 ，Python 不 会 引发 任何 错误 ， 因 为 给 元 组 
变量 重新 赋值 是 合法 的 : 


Original dimensions : 


Modified dimensions : 
400 
1606 


相 比 于 列表 ， 元 组 是 更 简单 的 数据 结构 。 如 果 需 要 存储 的 一 组 值 在 
程序 的 整个 生命 周期 内 都 不 变 ， 束 可 以 使 用 元 组 。 
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练习 4-13: 自助 餐 ” 有 一 家 自助 式 餐馆 ， 只 提供 五 种 简单 的 食 


请 想 出 五 种 简单 的 食品 ， 并 将 其 存储 在 一 个 元 组 中 。 


。 使 用 一 个 for 循环 将 该 餐馆 提供 的 五 种 食品 都 打印 出 来 。 


符 试 修改 其 中 的 一 个 元 素 ， 核 实 Python 确 实 会 拒绝 你 这 样 
做 


餐馆 调整 了 菜单 ， 替 换 了 它 提供 的 其 中 两 种 食品 。 请 编写 
一 个 这 样 的 代码 块 ， 给 元 组 变量 赋值 ， 并 使 用 一 个 for 循 
环 将 新 元 组 的 每 个 元 素 都 打印 出 来 。 


4.6 设置 代码 格式 


随 着 你 编写 的 程序 越 来 越 长 ， 有 必要 了 解 一 些 代码 格式 设置 约定 。 
请 花 时 间 让 你 的 代码 尽 可 能 易于 阅读 。 这 有 助 于 你 掌握 程序 是 做 什 
么 的 ， 也 可 以 帮助 他 人 理解 你 编写 的 代码 。 


为 确保 所 有 人 编写 的 代码 结构 都 大 致 一 致 ，Python 程 序 员 会 遵循 一 
些 格式 设置 约定 。 学 会 编写 整洁 的 Python 后 ， 就 能 明白 他 人 编写 的 
Python 代码 的 整体 结构 一 一 只 要 他 们 和 你 章 循 相同 的 指南 。 要 成 为 
专业 程序 员 ， 应 从 现在 开始 就 遵循 这 些 指南 ， 以 养 成 展 好 的 习惯 。 


4.6.1 格式 设置 指南 


要 提出 Python 语言 修改 建议 ， 需 要 编写 Python 改进 提案 〈Python 
Enhancement Proposal，PEP) 。PEP 8 是 最 古老 的 PEP 之 一 ， 问 
Python 程 序 员 提供 了 代码 格式 设置 指南 。PEP 8 的 篇 幅 很 长 ， 但 基 
本 上 与 复杂 的 编码 结构 相关 。 


Python 格 式 设置 指南 的 编写 者 深 知 ， 代 人 码 被 阅读 的 次 数 比 编写 的 次 
数 多 。 代 码 编写 出 来 后 ， 调 试 时 需要 阅读 ， 给 程序 添加 新 功能 时 ， 
需要 人 花 很 长 的 时 间 阅 读 ， 与 其 他 程序 员 分 享 代码 时 ， 这 些 程序 员 也 
会 阅读 。 

如 果 一 定 要 在 让 代码 易于 编写 和 易于 阅读 之 间 做 出 选择 ，Python 程 
i 


4.6.2” 缩 进 


PEP 8 建议 每 级 缩 进 都 使 用 四 个 空格 。 这 既 可 提高 可 该 性 ， 又 留 下 
了 足够 的 多 级 缩 进 空 间 。 


在 字 处 理 文档 中 ， 大 家 和 向 使 用 制 表 符 而 不 是 空格 来 缩 进 。 对 于 字 
处 理 文档 来 说 ， 这 样 做 的 效果 很 好 ， 但 混合 使 用 制 表 符 和 空格 会 让 
Python 解 释 器 感到 迷惑 。 每 球 文 本 编辑 器 部 提供 了 一 种 设置 ， 可 将 
你 输入 的 制 表 符 转换 为 指定 数量 的 空格 。 你 在 编写 代码 时 绝对 应 该 


使 用 制 表 符 键 但 一 定 要 对 编辑 器 进行 设置 ， 使 其 在 文档 中 插入 空 
格 而 不 是 制 表 符 。 


在 程序 中 混合 使 用 制 表 符 和 空格 可 能 导致 极 难 排 得 的 问题 。 如 宁 混 
合 使 用 了 制 表 符 和 空格 ， 可 将 文件 中 的 所 有 制 表 符 都 转换 为 空格 ， 
大 多 数 编辑 器 提供 了 这 样 的 功能 。 


4.6.3 ” 行 长 


很 多 Python 程序 员 建 议 每 行 不 超过 80 字 符 。 最 初 制定 这 样 的 指南 

时 ， 在 大 多 数 计算 机 中 ， 终 端 窗 口 每 行 只 能 容纳 79 字 符 。 当 前 ， 计 
算 机 屏 磋 每 行 可 容纳 的 字符 数 多 得 多 ， 为 何 还 要 使 用 79 字 符 的 标准 
行 长 呢 ? 这 里 有 别 的 原因 。 专 业 程 序 员 通 种 会 在 同一 个 屏幕 上 打开 
多 个 文件 ， 使 用 标准 行 长 可 以 让 他 们 在 屏幕 上 并 排 打 开 两 三 个 文件 
时 同时 看 到 各 个 文件 的 完整 行 。 PEP 8 还 建议 注释 的 行 长 不 应 超过 
72 字 符 ， 因 为 有 些 工 具 为 大 型 项 目 上 自动 生成 文档 时 ， 会 在 每 行 注释 
开头 添加 格式 化 字符 。 


PEP 8 中 有 关 行 长 的 指南 并 非 不 可 逾越 的 红线 ， 有 些小 组 将 最 大 行 
长 设置 为 99 字 符 。 在 学 习 期 间 ， 你 不 用 过 多 考虑 代码 的 行 长 ， 但 别 
二 了 ， 协 作 编 写 程序 时 ， 大 家 几乎 都 遵守 PEP 8 指南 。 在 大 多 数 编 
辑 右 中 ， 可 以 设置 一 个 视觉 标志 ( 通 第 是 一 条 竖 线 ) ， 让 你 知道 不 
能 越过 的 界线 在 什么 地 方 。 


注意 ”附录 B 介 绍 了 如 何 配 置 文本 编辑 器 ， 使 其 在 你 按 制 表 符 
键 时 插入 四 个 空格 ， 并 且 显 示 一 条 垂直 参考 线 ， 帮 助 你 遵守 行 
长 不 超过 79 字 符 的 约定 。 


4.6.4 衬 行 


要 将 程序 的 不 同 部 分 分 开 ， 可 使 用 空 行 。 你 应 该 使 用 空 行 来 组 织 程 
序 文件 ， 但 也 不 能 滥用 。 只 要 按 本 书 的 示例 展示 的 那样 做 ， 就 能 党 
握 其 中 的 平衡 。 例 如 ， 如 果 你 有 五 行 创建 列表 的 代码 ， 还 有 三 行 处 
理 该 列表 的 代码 ， 那 么 用 一 个 空 行将 这 两 部 分 隔 开 是 合适 的 。 然 
而 ， 你 不 应 使 用 三 四 个 空 行将 其 隔 开 。 


空 行 不 会 影响 代码 的 运行 ， 但 会 影响 代码 的 可 读 性 。Python 解 释 器 
根据 水 平 缩 进 情况 来 解读 代码 ， 但 不 关心 垂直 间距 。 


4.6.5 ”其 他 格式 设置 指南 


PEP 8 还 有 很 多 其 他 的 格式 设置 建议 ， 但 这 些 指南 针对 的 程序 大 多 
比 目 前 为 止 本 书 提 到 的 程序 复杂 。 等 介绍 更 复杂 的 Python 结构 时 ， 
我 们 再 来 分 胖 相 关 的 PEP 8 指南 。 


动手 试 一 斌 


练习 4-14: PEP 8 ”请 访问 Python 网 站 并 搜索 "PEP 8 一 Style 
Guide for Python Code”， 阅 读 PEP 8 格式 设置 指南 。 当 前 ， 这 
些 指南 适用 的 情况 不 多 ， 但 可 以 大 致 浏览 一 下 。 


练习 4-15: 代码 审核 “从 本 章 编 写 的 程序 中 选择 三 个 ， 根 据 
PEP 8 指南 对 它们 进行 修改 。 


每 级 缩 进 都 使 用 四 个 空格 。 对 你 使 用 的 文本 编辑 器 进行 设 
置 ， 使 其 在 你 按 Tab 键 时 插入 四 个 空格 。 如 果 你 还 没有 这 
样 做 ， 现 在 就 去 做 吧 (有 关 如 何 设置 ， 请 参阅 附录 B) 。 
每 行 都 不 要 超过 80 字 符 。 对 你 使 用 的 编辑 器 进行 设置 ， 使 
其 在 第 80 个 字符 处 显示 一 条 垂直 参考 线 。 

不 要 在 程序 文件 中 过 多 使 用 空 行 。 


4.7 小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 高 效 地 处 理 列表 中 的 元 素 ; 如 何 使 

用 for 循环 遍历 列表 ，Python 如 何 根据 缩 进 来 确定 程序 的 结构 ， 以 
及 如 何 避 免 一 些 溃 见 的 缩 进 错误 ; 如 何 创 建 简 单 的 数字 列表 ， 以 及 
可 对 数字 列表 执行 的 一 些 操作 ;， 如 何 通 过 切片 来 使 用 列表 的 一 部 分 
和 复制 列表 。 你 还 学 习 了 元 组 ( 它 对 不 应 变化 的 值 提供 了 一 定 程度 
2000 3 0 0 
阅读 。 


在 第 5 章 中 ， 你 将 学 习 如 何 使 用 if 语句 在 不 同 的 条 件 下 采取 不 同 的 
彰 施 ;， 如 何 将 一 组 较 复 林 的 条 件 测 试 组 合 起 来 ， 并 在 满足 特定 条 件 
时 采取 相应 的 措施 。 你 还 将 学 习 如 何在 所 历 列表 时 ， 通 过 使 用 if 
语句 对 特定 元 系 采 取 特 定 的 措施 。 


if 语句 


编程 时 经 疝 需 要 检查 一 系列 条 件 ， 并 据 此 决定 采 
在 Python 中 ，jif 语句 让 你 能 够 检查 程序 的 当前 状 
态 ， 并 采取 相应 的 措施 。 


在 本 章 中 ， 你 将 学 习 条 件 测试 ， 以 检查 所 关心 的 任何 条 件 。 你 
将 学 习 简 单 的 if 语句 ， 以 及 创建 一 系列 复杂 的 证 语句 来 确定 
当前 到 底 处 于 什么 情形 。 接 下 来 ， 你 将 把 学 到 的 知识 应 用 于 列 
表 ， 编 写 一 个 for 循环 ， 以 一 种 方式 处 理 列 表 中 的 大 多 数 元 

素 ， 并 以 另 一 种 方式 处 理 包含 特定 值 的 元 素 。 


5.1 一 个 简单 示例 


下 面 是 一 个 简短 的 示例 ， 演 示 了 如 何 使 用 if 语句 来 正确 地 处 理 特 
殊 情形 。 假 设 你 有 一 个 汽车 列表 ， 并 想 将 其 中 每 辆 汽车 的 名 称 打印 
出 来 。 对 于 大 多 数 汽车 ， 应 以 首 字母 大 写 的 方式 打印 其 名 称 ， 但 对 
于 汽车 名 "bmw' ， 应 以 全 大 写 的 方式 打印 。 下 面 的 代码 过 有 历 这 个 列 
表 ， 并 以 首 字母 大 写 的 方式 打印 其 中 的 汽车 名 ， 不 过 对 于 "bmw'"， 
则 以 全 大 写 的 方式 打印 : 


cars.py 


cars = ['audi', 'bmw', 'subaru', 'toyota'] 


for car in cars: 
@ if car == 'bmw': 
print(car.upper()) 
else: 
print(car.title()) 


这 个 示例 中 的 循环 首先 检查 当前 的 汽车 名 是 否 是 "bmw” ( 见 @) 。 
如 休 是 ， 赋 以 全 大 与 方式 打印 ， 否 则 以 首 字 母 大 写 的 方式 打印 : 


这 个 示例 涵盖 了 本 章 将 介绍 的 很 多 概念 。 下 面 完 来 介绍 可 用 来 在 程 
序 中 检查 条 件 的 测试 。 


5.2 ”条件 测试 


每 条 if 语句 的 核心 都 是 一 个 值 为 True 或 False 的 表达 式 ， 这 种 表 
达 式 称 为 条 件 测试 。Python 根 据 条 件 测试 的 值 为 True 还 是 False 
来 决定 是 否 执 行 if 语句 中 的 代码 。 如 果 条 件 测试 的 值 为 True ， 
Python 就 执行 紧 跟 在 if 语句 后 面 的 代码 ;如 果 为 False ，Python 惑 
忽略 这 些 代码 。 


5.2.1 检查 是 否 相 等 


大 多 数 条 件 测 试 将 一 个 变量 的 当前 值 同 特定 值 进行 比较 。 最 简单 的 
条 件 测 试 检 查 变 量 的 值 是 否 与 特定 值 相等 : 


@ >>> car = 'bmw’ 
@ >>> car == 'bmw'’ 


True 


首先 使 用 一 个 等 号 将 car 的 值 设 置 为 'bmw'〈 见 @) ， 这 种 做 法 你 
己 经 见 过 很 多 次 。 接 下 来 ， 使 用 两 个 等 号 〈== ) 检查 car 的 值 是 
否 为 "bmw”《〔〈 见 铺 ) 。 这 个 相等 运算 符 在 两 边 的 值 相 等 时 返回 
True ， 人 否则 返回 False 。 在 本 例 中 ， 两 边 的 值 相 等 ， 因 此 Python 
返回 True 。 


如 果 变 量 car 的 值 不 是 "bmw' ， 上 述 测试 将 返回 False : 


@ >>> car = 'audi' 
@ >>> car == 'bmw'’ 


False 


一 个 等 号 是 陈述 ， 于 是 @ 处 的 代码 可 解读 为 :将 变量 car 的 值 设置 
为 'audi' 。 两 个 等 号 则 是 发 问 ， 于 是 @ 处 的 代码 可 解读 为 ， 变 量 
的 值 是 'bmw' 吗 ? 大 多 数 编程 语言 使 用 等 号 的 方式 与 这 里 演示 
I 相同 。 


5.2.2 检查 是 否 相 等 时 忽略 大 小 写 
碍 


门 
在 Python 中 检查 是 否 相 等 时 区 分 大 小 写 。 例 如 ， 两 个 大 小 写 不 同 的 
值 被 视 为 不 相等 : 


>>> car = 'Audi' 
>>> car == 'audi' 


False 


如 末 大 小 写 很 重要 ， 这 种 行为 有 其 优点 。 但 如 果 大 小 写 无 天 紧要 ， 
只 想 检 查 变 量 的 值 ， 可 将 变量 的 值 转换 为 小 写 ， 再 进行 比较 : 


>>> car = 'Audi' 
>>> car.lower() == 
True 


无 论 值 'Audi' 的 大 小 写 如 何 ， 上 述 测 试 都 将 返回 True ， 因 为 该 测 
试 不 区 分 大 小 写 。 函 数 lower() 不 会 修改 最 初 赋 给 变量 car 的 值 ， 
因此 进行 这 样 的 比较 时 不 会 影响 原来 的 变量 : 


@ >>> car = 'Audi' 
@ >>> car.lower() == "audi' 
True 


日 >>> car 
Audi 


在 @ 处 ， 将 首 字母 大 写 的 字符 串 'Audi' 赋 给 变量 car 。 在 全 处 ， 
获取 变量 car 的 值 并 将 其 转换 为 小 写 ， 再 将 结果 与 字符 串 'audi' 
进行 比较 。 这 两 个 字符 串 相 同 ， 因 此 Python 返回 True 。 从 全 处 的 
输出 可 知 ， 方 法 lower() 并 没有 影响 关联 到 变量 car 的 值 。 


网 站 采用 类 似 的 方式 让 用 户 输入 的 数据 符合 特定 的 格式 。 例 如 ， 网 
站 可 能 使 用 类 似 的 测试 来 确保 用 户 名 是 独一无二 的 ， 而 并 非 只 是 与 
为 一 个 用 户 名 的 大 小 写 不 同 。 用 户 提 交 新 的 用 户 名 时 ， 将 把 它 转 换 


为 小 写 ， 并 与 所 有 既 有 用 户 名 的 小 写 版 本 进行 比较 。 执 行 这 种 检查 
时 ， 如 果 已 经 有 用 户 名 'john' (不 管 大 小 写 如 何 ) ， 则 用 户 提交 
用 户 名 'John' 时 将 遭 到 拒绝 。 


5.2.3 ”检查 是 否 不 相等 


要 判断 两 个 值 是 否 不 等 ， 可 结合 使 用 惊叹 号 和 等 写 〈(!= ) ， 其 中 
的 惊叹 号 表示 不 ， 其 他 很 多 编程 语言 中 也 是 如 此 。 


下 面 再 使 用 一 条 if 语句 来 演示 如 何 使 用 不 等 运算 符 。 我 们 将 把 要 
求 的 比 相 配料 赋 给 一 个 变量 ， 再 打印 一 条 消息 ， 指 出 顾客 要 求 的 配 


料 是 否 是 意 式 小 银 鱼 (anchovies) : 


toppings.py 
requested topping = "mushrooms， 


©@ if requested topping != "anchovies ': 


print("Hold the anchovies!") 


全 处 的 代码 行将 requested_topping 的 值 与 'anchovies' 进行 比 
较 。 如 果 这 两 个 值 不 相等 ，Python 将 返回 True ， 进 而 执行 紧 跟 
在 if 语句 后 面 的 代码 ; 如果 相 等 ，Python 将 返回 False ， 因 此 不 执 
行 紧 跟 在 if 语句 后 面 的 代码 。 


因为 requested_topping 的 值 不 是 "anchovies' ， 所 以 执行 函数 
调用 print(): 


Hold the anchovies! 


你 编写 的 大 多 数 条 件 表达 式 检查 两 个 值 是 否 相 等 ， 但 有 时 候 检 村 两 
个 值 是 否 不 等 的 效率 更 高 。 


5.2.4 数值 比较 


检查 数值 非 第 简单 。 例 如 ， 下 面 的 代码 检查 一 个 人 是 否 是 18 岁 : 


>>> age = 18 
>>> age == 18 


True 


还 可 检查 两 个 数 是 否 不 等 。 例 如 ， 下 面 的 代码 在 提供 的 答案 不 正确 
时 打印 一 条 消息 : 


magic_number.py 


answer = 17 
@ if answer != 42: 
print("That is not the correct answer. Please try again!") 


answer 的 值 (17 ) 不 是 42 ，@@ 处 的 条 件 得 到 满足 ， 因 此 缩 进 的 
代码 块 得 以 执行 : 


That is not the correct answer. Please try again! 


条 件 语句 中 可 包含 各 种 数学 比较 ， 如 小 于 、 小 于 等 于 、 大 于 、 大 于 
于 : 


4 
= 于 


在 if 语句 中 可 使 用 各 种 数学 比较 ， 这 让 你 能 够 直接 检查 关心 的 条 


件 。 


5.2.5 ”检查 多 个 条 件 


你 可 能 想 同 时 检查 多 个 条 件 。 例 如 ， 有 时 候 需 要 在 两 个 条 件 都 
为 True 时 才 执 行 相 应 的 操作 ， 而 有 时 候 只 要 求 一 个 条 件 为 True 。 
在 这 些 情况 下 ， 关 键 字 and 和 or 可 助 你 一 辟 之 力 。 


a 使 用 and 检查 多 个 条 件 
要 检查 是 否 两 个 条 件 都 为 Trrue ， 可 使 用 关键 字 and 将 两 个 条 


件 测 试 合 而 为 一 。 如 果 每 个 测试 都 通过 了 ， 整 个 表达 式 就 
为 True ; 如 末 至 少 一 个 测试 没有 通过 ， 整 个 表达 式 束 为 False 


例如 ， 要 检查 是 否 两 个 人 都 不 小 于 21 岁 ， 可 使 用 下 和 面 的 测试 : 


© >>> age 0 = 22 
>>> age 1 = 18 

@ >>> age 0 >= 21 and age 1 >= 21 
False 


© >>> age 1 = 22 
>>> age 6 >= 21 and age 1 >= 21 
True 


在 @ 处 ， 定 义 两 个 用 于 存储 年 龄 的 变量 : age_8 和 age_1 。 在 
人 @ 处 ， 检 查 这 两 个 变量 是 否 都 大 于 或 等 于 21。 左 边 的 测试 通过 
了 ， 但 右边 的 测试 没有 通过 ， 因 此 整个 条 件 表达 式 的 结果 
为 False 。 在 全 处 ， 将 age_1 改 为 22， 这 样 age_1 的 值 大 于 
21， 因 此 两 个 测试 都 通过 了 ， 导 致 整个 条 件 表达 式 的 结果 


为 True 。 


为 改善 可 读 性 ， 可 将 每 个 测试 分 别 放 在 一 对 圆 括号 内 ， 但 并 非 
必须 这 样 做 。 如 果 你 使 用 圆 括号 ， 测 试 将 类 似 于 下 面 这 样 : 


(age 6 >= 21) and (age 1 >= 21) 


b. 使 用 or 检查 多 个 条 件 


关键 字 or 也 能 够 让 你 检查 多 个 条 件 ， 但 只 要 至 少 一 个 条 件 满 
足 ， 束 能 通过 整个 测试 。 仪 当 两 个 测试 都 没有 通过 时 ， 使 用 or 
的 表达 式 才 为 False 。 


下 面 再 次 检查 两 个 人 的 年 龄 ， 但 检查 的 条 件 是 至 少 一 个 人 的 年 
龄 不 小 于 21 岁 : 


@ >>> age 0 = 22 
>>> age 1 = 18 

@ >>> age 0 >= 21 or age 1 >= 21 
True 


© >>> age 0 = 18 


>>> age 6 >= 21 or age 1 >= 21 
False 


同样 ， 首 先 定 义 两 个 用 于 存储 年 龄 的 变量 ( 见 @) 。 四 处 对 

age_6 的 测试 通过 了 ， 因 此 整个 表达 式 的 结果 为 True 。 接 下 
来 ， 将 age_6 减 小 为 18。 在 全 处 的 测试 中 ， 两 个 测试 都 没有 通 
过 ， 因 此 整个 表达 式 的 结果 为 False 。 


5.2.6 ”检查 特定 值 是 否 包含 在 列表 中 


有 时 候 ， 执 行 操 作 前 必须 检查 列表 是 否 包 含 特定 的 值 。 例 如 ， 结 
用 户 的 注册 过 程 前 ， 可 能 需要 检查 他 提供 的 用 户 名 是 否 已 包含 在 用 
户 名 列表 中 。 在 地 图 程序 中 ， 可 能 需要 检查 用 户 提 交 的 位 置 是 否 包 
含 在 已 知 位 置 列表 中 。 


要 判断 特定 的 值 是 否 已 包含 在 列表 中 ， 可 使 用 关键 字 in 。 下 面 来 
看 看 你 可 能 为 比 蔷 店 编写 的 一 些 代 码 。 这 些 代 码 首先 创建 一 个 列 

i 
该 允 i 


>>> requested toppings = ['mushrooms', 'onions', "pineapple '] 
@ >>> 'mushrooms' in requested toppings 


True 
@ >>> 'pepperoni' in requested toppings 
False 


在 @ 处 各 处， 关键 字 in 让 Python 检查 列 
表 requested toppings 是 否 包 含 'mushrooms' 和 'pepperoni' 


。 这 种 技术 很 有 用 ， 让 你 能 够 在 创建 一 个 列表 后 ， 轻 松 地 检查 其 中 


是 否 包 含 特定 的 值 。 
5.2.7 检查 特定 值 是 否 不 包含 在 列表 中 
还 有 些 时 候 ， 确 定 特 定 的 值 未 包含 在 列表 中 很 重要 。 在 这 种 情况 


下 ， 可 使 用 关键 字 not in 。 例 如 ， 有 一 个 列表 ， 其 中 包含 被 禁止 
在 论坛 上 发 表 评 论 的 用 户 ， 可 以 在 允许 用 户 提交 评论 前 检查 他 是 否 


banned_users.py 


banned users = ['andrew', 'carolina', 'david'] 
user = "marie' 


@ if user not in banned users: 
print(f"{user.title()}, you can post a response if you wish.") 


@@ 处 的 代码 行 明白 易 懂 : 如 果 user 的 值 未 包含 在 列 
表 banned_users 中 ，Python 将 返回 True ， 进 而 执行 缩 进 的 代码 
行 ; 


用 户 'marie' 未 包含 在 列表 banned_users 中 ， 因 此 她 将 看 到 一 条 
邀请 她 发 表 评 论 的 消息 : 


Marie, you can post a response if you wish. 


5.2.8 布尔 表达 式 


随 着 你 对 编程 的 了 解 越 来 越 深入 ， 将 遇 到 术语 布尔 表达 式 ， 它 不 
过 是 条 件 测试 的 别名 。 与 条 件 表达 式 一 样 ， 布 尔 表达 式 的 结果 要 人 么 
为 True ， 要 么 为 False 。 


布尔 值 通 党 用 于 记录 条 件 ， 如 游戏 是 否 正 在 运行 ， 或 者 用 户 是 否 可 
以 编辑 网 站 的 特定 内 容 : 


game_active = True 
can_edit = False 


在 跟 踩 程序 状态 或 程序 中 重要 的 条 件 方面 ， 布 尔 值 提供 了 一 种 高 效 
的 方式 。 


动手 试 一 斌 
练习 5-1: 条 件 测试 “编写 一 系列 条 件 测试 ， 将 每 个 测试 以 及 


对 其 结果 的 预测 和 实际 结果 打印 出 来 。 你 编写 的 代码 应 类 似 于 
下 面 这 样 : 


car = "Subaru' 
print("Is car == 'subaru'? I predict True.") 
print(car == 'subaru') 


print("\nIs car == "audi'? I predict False.") 
print(car == 'audi') 


。 详细 研究 实际 结果 ， 直 到 你 明白 它 为 何 为 True 或 False 


。 创建 至 少 10 个 测试 ， 且 其 中 结果 分 别 为 True 和 False 的 
测试 都 至 少 有 5 个 。 


练习 5-2: 更 多 条 件 测试 ”你 并 非 只 能 创建 10 个 测试 。 如 果 想 
尝试 做 更 多 比较 ， 可 再 编写 一 些 测试 ， 并 将 它们 加 入 
conditional_tests.py 中 。 对 于 下 面 列 出 的 各 种 情况 ， 人 至 少 编写 两 
个 结果 分 别 为 True 和 False 的 测试 。 


。 检查 两 个 字符 串 相 等 和 不 等 。 

。 使 用 方法 lower() 的 测试 。 

。 涉及 相等 、 不 等 、 大 于 、 小 于 、 大 于 等 于 和 小 于 等 于 的 数 
值 测试 。 

。 使 用 关键 字 and 和 or 的 测试 。 

。 测试 特定 的 值 是 否 包 含 在 列表 中 。 

。 测试 特定 的 值 是 否 未 包含 在 列表 中 。 


5.3 if 语句 


理解 条 件 测 试 后 ， 惑 可 以 开始 编写 if 语句 了 。if 语句 有 很 多 种 ， 
选择 使 用 哪 种 取决 于 要 测试 的 条 件数 。 前 面 讨论 条 件 测 试 时 ， 列 举 
了 多 个 计 语句 示例 ， 下 面 更 深入 地 讨论 这 个 主题 。 


5.3.1 ”简单 的 if 语句 
最 简单 的 if 语句 只 有 一 个 测试 和 一 个 操作 : 


if conditional test: 
do something 


第 一 行 可 包含 任何 条 件 测 试 ， 而 在 紧 跟 在 汕 试 后 面 的 缩 进 代码 块 
中 ， 可 执行 任何 操作 。 如 果 条 件 测试 的 结果 为 True ，Python 束 会 
执行 紧 跟 在 if 语句 后 面 的 代码 ， 人 否则 Python 将 忽略 这 些 代 码 。 


假设 有 一 个 表示 茶 人 年 龄 的 变量 ， 而 你 想 知 道 这 个 人 是 否 符合 投票 
的 年 龄 ， 可 使 用 如 下 代码 : 


voting.py 


age = 19 
@ if age >= 18: 


@ print("You are old enough to vote!") 


在 @ 处 ，Python 检 查 变量 age 的 值 是 否 大 于 或 等 于 18。 管 案 是 肯定 
的 ， 因 此 Python 执 行人 处 缩 进 的 函数 调用 print(): 


You are old enough to vote! 


在 if 语句 中 ， 缩 进 的 作用 与 在 for 循环 中 相同 。 如 果 测试 通过 


了 ， 将 执行 if 语句 后 面 所 有 缩 进 的 代码 行 ， 人 否则 将 忽略 它们 。 


在 紧 跟 if 语句 后 面 的 代码 块 中 ， 可 根据 需要 包含 任意 数量 的 代码 
行 。 下 面 在 一 个 人 符合 投票 年 龄 时 再 打印 一 行 输出 ， 问 他 是 否 登 记 
Te 


age = 19 
if age >= 18: 
print("You are old enough to vote!") 


print("Have you registered to vote yet?") 


条 件 测 试 通 过 了 ， 而 且 两 个 函数 调用 print() 都 缩 进 了 ， 因 此 它们 
都 将 执行 : 


You are old enough to vote! 
Have you registered to vote yet? 


如 果 age 的 值 小 于 18， 这 个 程序 将 不 会 有 任何 输出 。 


5.3.2 ”if-else 语句 


我 们 经 常 需要 在 条 件 测试 通过 时 执行 一 个 操作 ， 在 没有 通过 时 执行 
另 一 个 操作 。 在 这 种 情况 下 ， 可 使 用 Python 提 供 的 jf-else 语 

人 名 。if-else 语句 块 类 似 于 简单 的 if 语句 ， 但 其 中 的 else 语句 让 
你 能 够 指定 条 件 测试 未 通过 时 要 执行 的 操作 。 


下 面 的 代码 在 一 个 人 符合 投票 年 龄 时 显示 与 前 面相 同 的 消息 ， 在 不 


符合 时 显示 一 条 新 消 忆 : 


age = 17 
@ if age >= 18: 
print("You are old enough to vote!") 
print("Have you registered to vote yet?") 
@ else: 
print("Sorry, you are too young to vote.") 
print("Please register to vote as soon as you turn 18!") 


[L | 


如 果 @@ 处 的 条 件 测试 通过 了 ， 就 执行 第 一 组 缩 进 的 函数 调 

用 print() 。 如 果 测 试 结果 为 False ， 就 执行 人 处 的 else 代码 
块 。 这 次 age 小 于 18， 条 件 测试 未 通过 ， 因 此 执行 else 代码 块 中 
的 代码 : 


Sorry, you are too young to vote. 
Please register to vote as soon as you turn 18! 


上 述 代码 之 所 以 可 行 ， 是 因为 只 存在 两 种 情形 : 要 么 符合 投票 年 

龄 ， 要 么 不 符合 。if-else 结构 非常 适合 用 于 让 Python 执行 两 种 操 

J 
Sl he 


5.3.3 if-elif-else 结构 


我 们 经 常 需要 检查 超过 两 个 的 情形 ， 为 此 可 使 用 Python 提 供 的 if- 
elif-else 结构 。Python 只 执行 jf-elif-else 结构 中 的 一 个 代码 
块 。 它 依次 检查 每 个 条 件 测试 ， 直 到 遇 到 通过 了 的 条 件 测试 。 测 试 
通过 后 ，Python 将 执行 紧 跟 在 它 后 面 的 代码 ， 并 跳 过 余下 的 测试 。 


在 现实 世界 中 ， 很 多 情况 下 需要 考虑 的 情形 超过 两 个 。 例 如 ， 来 看 
一 个 根据 年 龄 段 收 费 的 游乐 场 : 


。4 岁 以 下 免费， 
e。 4 一 18 岁 收费 25 美 元 ; 
。18 岁 ( 含 ) 以 上 收费 40 美 元 。 


如 采 只 使 用 一 条 if 语句 ， 该 如 何 确定 门票 价格 呢 ? 下 面 的 代码 确 
定 一 个 人 所 属 的 年 龄 段 ， 并 打印 一 条 包含 门票 价格 的 消息 : 


amusement_park.py 


age = 12 
@ if age < 4: 


print("Your admission cost is $6.") 
@ elif age < 18: 

print("Your admission cost is $25.") 
© else: 

print("Your admission cost is $406.") 


OO 处 的 if 测试 检查 一 个 人 是 否 不 满 4 岁 。 如 果 是 ，Python 就 打印 一 
条 合适 的 消息 ， 并 跳 过 余下 测试 。 久 处 的 elif 代码 行 其 实 是 另 一 


Re 仅 在 前 面 的 测试 未 通过 时 才 会 运行 。 在 这 里 。 我们 知 
道 这 个 人 不 小 于 4 岁 ， 因 为 第 一 个 测试 未 通过 。 如 果 这 个 人 未 满 18 
岁 ， Python 将 打印 相应 的 消息 ， 并 跳 过 else 代码 块 。 如 果 if 测试 
和 elif 测试 都 未 通过 ， Python 将 运 云 行人 @ 处 else 代码 块 中 的 代码 。 


在 本 例 中 ，@ 处 测试 的 结果 为 False ， 因 此 不 执行 其 代码 块 。 然 


而 ， 第 二 个 测试 的 结果 为 True (12 小 于 18) ， 因 此 执行 其 代码 
块 。 输 出 为 一 个 句子 ， 同 用 户 指 出 门票 价格 : 


Your admission cost is $25. 


只 要 年 龄 超过 17 岁 ， 前 两 个 测试 束 都 不 能 通过 。 在 这 种 情况 下 ， 将 
执行 else 代码 块 ， 指 出 门票 价格 为 40 美 元 。 


为 了 让 代码 更 人 简洁， 可 不 在 if-elif-else 代码 块 中 打印 门票 价 


格 ， 而 只 在 其 中 设置 门票 价格 ， 并 在 它 后 面 添加 一 个 简单 的 函数 调 
用 print(): 


age = 12 
if age < 4: 
@ price = 6 
elif age < 18: 
@ price = 25 
else: 
@ price = 406 


@ print(f"Your admission cost is ${price}.") 


OO 处 、 介 处 和 人 @ 处 的 代码 行 像 前 一 个 示例 那样 ， 根 据 人 的 年 龄 设置 
变量 price 的 值 。 在 if-elif-else 结构 中 设置 price 的 值 后 ， 一 
条 未 缩 进 的 函数 调用 print() @ 会 根据 这 个 变量 的 值 打印 一 条 消 
忠 ， 指 出 门票 的 价格 。 


这 些 代 码 的 输出 与 前 一 个 示例 相同 ， 但 if-elif-else 结构 的 作用 
更 小 : 它 只 确定 门票 价格 ， 而 不 是 在 确定 门票 价格 的 同时 打印 一 条 
消息 。 除 效率 更 高 外 ， 这 些 修订 后 的 代码 还 更 容易 修改 : 要 调整 输 
出 消息 的 内 容 ， 只 需 修 改 一 个 而 不 是 三 个 函数 调用 print() 。 


5.3.4 ”使 用 多 个 elif 代码 块 


可 根据 需要 使 用 任意 数量 的 elif 代码 块 。 例 如 ， 假 设 前 述 游乐 场 
要 给 老年 人 打折 ， 可 再 添加 一 个 条 件 测试 ， 判 断 顾客 是 否 符合 打折 
下 面 假 设 对 于 65 岁 〈 含 ) 以 上 的 老人 ， 可 半价 〈 即 20 美 元 ) 
购买 门票 : 


age = 12 


if age < 4: 
price = 0 
elif age < 18: 
price = 25 
@ elif age < 65: 
price = 406 
@ else: 
price = 20 


print(f"Your admission cost is ${price}.") 


这 些 代 码 大 多 未 变 。 第 二 个 elif 代码 块 ( 见 @) 通过 检查 确定 年 
龄 不 到 65 妈 后 ， 才 将 门票 价格 设置 为 全 票 价格 一 一 40 美 元 。 请 注 
意 ， 在 else 代码 块 〈( 见 人 @) 中 ， 必 须 将 所 赋 的 值 改 为 20， 因 为 仅 
当年 龄 超过 65 岁 〈 含 ) 时 ， 才 会 执行 这 个 代码 块 。 


5.3.5 ”省 略 else 代码 块 


Python 并 不 要 求 if-elif 结构 后 面 必须 有 else 代码 块 。 在 有 些 情 
况 下 ，else 代码 块 很 有 用 ; 而 在 其 他 一 些 情况 下 ， 使 用 一 条 elif 
语句 来 处 理 特定 的 情形 更 清晰 : 


age = 12 


if age < 4: 
price = 6 
elif age < 18: 
price = 25 
elif age < 65: 
price = 406 
@ elif age >= 65: 
price = 26 


print(f"Your admission cost is ${price}.") 


@@ 处 的 elif 代码 块 在 顾客 的 年 龄 超过 65 岁 〈 含 ) 时， 将 价格 设置 
为 20 美 元 。 这 比 使 用 else 代码 块 更 清晰 些 。 经 过 这 样 的 修改 后 ， 
每 个 代码 块 都 仅 在 通过 了 相应 的 测试 时 才 会 执行 。 


else 是 一 条 包罗 万 象 的 语句 ， 只 要 不 满足 任何 if 或 elif 中 的 条 
件 测试 ， 其 中 的 代码 就 会 执行 。 这 可 能 引入 无 效 甚至 恶意 的 数据 。 
如 果 知 道 最 终 要 测试 的 条 件 ， 应 考虑 使 用 一 个 elif 代码 块 来 代 蔡 
else 代码 块 。 这 样 就 可 以 肯定 ， 仅 当 满 足 相 应 的 条 件 时 ， 代 码 才 


5.3.6 ”测试 多 个 条 件 


if-elif-else 结构 功能 强大 ， 但 仅 适 合用 于 只 有 一 个 条 件 满 足 的 
情况 : 遇 到 通过 了 的 测试 后 ，Python 就 跳 过 余下 的 测试 。 这 种 行为 
很 好 ， 效 率 很 高 ， 让 你 能 够 测试 一 个 特定 的 条 件 。 


然而 ， 有 了 时候 必须 检查 你 关心 的 所 有 条 件 。 在 这 种 情况 下 ， 应 使 用 
一 系列 不 包含 elif 和 else 代码 块 的 简单 if 语句 。 在 可 能 有 多 个 
条 件 为 True 且 需 要 在 每 个 条 件 为 True 时 都 采取 相应 措施 时 ， 适 合 
使 用 这 种 方法 。 


下 面 再 来 看 看 前 面 的 比萨 店 示例 。 如 果 顾 客 点 了 两 种 配料 ， 就 需要 
确保 在 其 比 桂 中 包含 这 些 配 料 : 


toppings.py 


@ requested toppings = ['mushrooms', 'extra cheese'| 


'mushrooms' in requested toppings: 
print("Adding mushrooms.") 
"pepperoni' in requested toppings: 
print("Adding pepperoni.") 


"extra cheese' in requested toppings: 
print("Adding extra cheese.") 


print("\nFinished making your pizzal!") 


首先 创建 一 个 列表 ， 其 中 包含 顾客 点 的 配料 《 见 @) 。 人 处 的 if 
语句 检查 顾客 是 否 点 了 配料 茧 妇 (mushrooms) 。 如 果 点 了 ， 就 打 
印 一 条 确认 消息 。 全 处 检查 配料 辣 香 肠 (pepperoni) 的 代码 也 是 一 
个 简单 的 if 语句 ， 而 不 是 elif 或 else 语句 。 因 此 不 管 前 一 个 测 
试 是 否 通 过 ， 都 将 进行 这 个 测试 。 四 处 的 代码 检查 顾客 是 否 要 求 多 
加 芝士 (extra cheese) 。 不 管 前 两 个 测试 的 结果 如 何 ， 都 会 执行 这 
些 代 码 。 每 当 这 个 程序 运行 时 ， 都 会 执行 这 三 个 独立 的 测试 。 


因为 本 例 检 查 了 每 个 条 件 ， 所 以 将 在 比 院 中 添加 芯 菇 并 多 加 芝士 : 


Adding mushrooms . 
Adding extra cheese . 


Finished making your pizzal 


如 果 像 下 面 这 样 转 而 使 用 if-elif-else 结构 ， 代 码 将 不 能 正确 运 
行 ， 因 为 有 一 个 测试 通过 后 ， 就 会 跳 过 余下 的 测试 : 


requested toppings = ['mushrooms', "extra cheese '] 


if 'mushrooms' in requested _ toppings : 
print("Adding mushrooms.") 


elif 'pepperoni' in requested toppings: 
print("Adding pepperoni.") 

elif "extra cheese' in requested toppings: 
print("Adding extra cheese.") 


print("\nFinished making your pizza!") 


第 一 个 测试 检查 列表 中 是 否 包 含 'mushrooms' 。 它 通过 了 ， 因 此 
将 在 比萨 中 添加 蘑菇 。 然 而 ，Python 将 跳 过 if-elif-else 结构 中 


口 
余下 的 测试 ， 不 再 检查 列表 中 是 否 包 含 'pepperoni' 和 'extra 


cheese' 。 结 果 是 ， 将 添加 顾客 点 的 第 一 种 配料 ， 但 不 会 添加 其 他 
配料 : 


Adding mushrooms. 


Finished making your pizzal 


总 之 ， 如 果 只 想 执 行 一 个 代码 块 ， 就 使 用 if-elif-else 结构 ; 如 
果 要 执行 多 个 代码 块 ， 就 使 用 一 系列 独立 的 if 语句 。 


动手 试 一 斌 
练习 5-3: 外 星人 颜色 ”假设 在 游戏 中 刚 射 杀 了 一 个 外 星人 ， 


请 创建 一 个 名 为 alien_color 的 变量 ， 并 将 其 赋值 为 "green' 
、 "yellow' 或 "red ' 。 


。 编写 一 条 if 语句 ， 检 查 外 星人 是 否 是 绿色 的 。 如 果 是 ， 
就 打印 一 条 消息 ， 指 出 玩家 获得 了 5 分 。 
。 编写 这 个 程序 的 两 个 版 本 ， 在 一 个 版 本 中 上 述 测 试 通过 
了 ， 而 在 男 一 个 版 本 中 未 通过 (未 通过 测试 时 没有 输 
由 


练习 5-4: 外 星人 颜色 2 像 练 习 5-3 那 样 设置 外 星人 的 颜色 ， 
并 编写 一 个 if-else 结构 。 


。 如 果 外 星人 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 因 射 杀 


本 


该 外 星人 获得 了 5 分 。 

如 果 外 星人 个 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 
了 10 分 。 

编写 这 个 程序 的 两 个 版 本 ， 在 一 个 版 本 中 执行 if 代码 
块 ， 在 为 一 个 版 本 中 执行 else 代码 块 。 


练习 5-5: 外 星人 颜色 3 将 练习 5-4 中 的 i1f-else 结构 改 
为 if-elif-else 结构 。 


如 果 外 星人 是 绿色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 
Ds 
如 果 外 星人 是 黄色 的 ， 就 打印 一 条 消息 ， 指 出 玩家 获得 了 


10 分 。 
如 果 外 星人 是 红色 的 ， 束 打印 一 条 消息 ， 指 出 玩家 获得 了 
15 分 5 


编写 这 个 程序 的 三 个 版 本 ， 分 别 在 外 星人 为 绿色 、 黄 色 和 
红色 时 打印 一 条 消息 。 


练习 5-6: 人 生 的 不 同 阶段 ”设置 变量 age 的 值 ， 再 编写 一 
个 if-elif-else 结构 ， 根 据 age 的 值 判断 一 个 人 处 于 人 生 的 
哪个 阶段 。 


如 末年 龄 小 于 2 岁 ， 束 打印 一 条 消 轧 ， 指 出 这 个 人 是 婴 
儿 。 
如 果 年 龄 为 2〈 含 ) 一 4 妈 ， 就 打印 一 条 消息 ， 指 出 这 个 人 


是 幼儿 。 

如 果 年 龄 为 4( 含 ) 一 13 妈 ， 就 打印 一 条 消 轧 ， 指 出 这 个 
人 是 儿童 。 

如 果 年 龄 为 13〈 含 ) 一 20 妈 ， 束 打印 一 条 消息 ， 指 出 这 个 
人 是 青少年 。 


如 果 年 龄 为 20( 含 ) ~~65 岁 ， 束 打印 一 条 消 恩 ， 指 出 这 个 
人 是 成 年 人 。 

如 果 年 龄 超过 65 岁 〈 含 ) ， 就 打印 一 条 消息 ， 指 出 这 个 人 
古老 年 人 。 


练习 5-7: 喜欢 的 水 果 “创建 一 个 列表 ， 其 中 包含 你 喜欢 的 水 


果 ， 


再 编写 一 系列 独立 的 if 语句 ， 检 查 列表 中 是 人 否 包 含 特定 


的 水 果 。 


。 将 该 列表 命名 为 favorite_fruits ， 并 在 其 中 包含 三 种 
水 果 。 
。 编写 5 条 if 语句 ， 否 包 含 在 列表 


中 。 如 果 是 ， 就 打印 一 条 消息 ， 下 面 是 一 个 例子 。 


You really like bananas! 


5.4 ”使 用 if 语句 处 理 列 表 


过 结合 使 用 if 语句 和 列表 ， 可 完成 一 些 有 趣 的 任务 : 对 列表 中 
特定 的 值 做 特 基 处 理 高 效 地 管理 不 断 变化 的 情形 ， 如 餐馆 是 否 还 
有 特定 的 食材 ;， 证明 代码 在 各 种 情形 下 都 将 按 预 期 那样 运行 。 


5.4.1 检查 特殊 元 素 


本 章 开 头 通过 一 个 简单 示例 演示 了 如 何 处 理 特 殊 值 "bmw ' 一 一 它 需 

要 采用 不 同 的 格式 进行 打印 。 现 在 你 对 条 件 测试 和 if 语句 有 了 大 
致 的 认识 ， 下 面 就 来 进一步 研究 如 何 检查 列表 中 的 特殊 值 ， 并 对 其 
做 合适 的 处 理 。 


继续 使 用 前 面 的 比 陡 店 示例 。 这 家 比 蔷 店 在 制作 比 节 时 ， 每 评 加 一 
种 配料 都 打印 一 条 消息 。 通 过 创建 一 个 列表 ， 在 其 中 包含 顾客 点 的 
配料 ， 并 使 用 一 个 循环 来 指出 添加 到 比 陡 中 的 配料 ， 能 以 极 高 的 效 
率 编写 这 样 的 代码 : 


toppings.py 


requested toppings = ['mushrooms', 'green peppers', 'extra cheese'] 


for requested topping in requested toppings: 


print(f"Adding {requested topping}.") 


print("\nFinished making your pizza!") 


输出 很 简单 ， 因 为 上 述 代码 不 过 是 一 个 简单 的 for 循环 : 


Adding mushrooms . 
Adding green peppers . 
Adding extra cheese . 


Finished making your pizzal 


然而 ， 如 果 比 陡 店 的 青椒 用 完了 ， 该 如 何 处 理 呢 ? 为 妥善 地 处 理 这 
种 情况 ， 可 在 for 循环 中 包含 一 条 if 语句 : 


requested toppings = ['mushrooms', "green peppers', "extra cheese '] 


for requested topping in requested toppings : 
@ if requested topping == 'green peppers': 
print("Sorry, we are out of green peppers right now.") 


@ else: 
print(f"Adding {requested topping}.") 


print("\nFinished making your pizzal!") 


这 里 在 比萨 中 添加 每 种 配料 前 都 进行 检查 。 伯 处 的 代码 检查 顾客 是 
售 点 了 青椒 。 如 条 是 ， 瓯 显示 一 条 消 轧 ， 指 出 不 能 点 青椒 的 原因 。 
多 处 的 else 代码 块 确保 其 他 配料 都 将 添加 到 比萨 中 。 


输出 表明 ， 已 经 妥善 地 处 理 了 顾客 点 的 每 种 配料 : 


Adding mushrooms . 
Sorry, we are out of green peppers right now. 
Adding extra cheese. 


Finished making your pizzal 


5.4.2 ”确定 列表 不 是 空 的 


到 目前 为 止 ， 我 们 对 于 处 理 的 每 个 列表 都 做 了 一 个 简单 的 假设 
假设 它们 都 至 少 包 含 一 个 元 素 。 因 为 马上 就 要 让 用 户 来 提供 存储 在 
列表 中 的 信息 ， 所 以 不 能 再 假设 循环 运行 时 列表 不 是 空 的 。 有 和 鉴于 
此 ， 在 运行 for 循环 前 确定 列表 是 否 为 空 很 重要 。 


下 面 在 制作 比 蔷 前 检查 顾客 点 的 配料 列表 是 否 为 空 。 如 有 果 列 表 为 


空 ， 就 向 顾客 确认 是 否 要 点 原味 比萨 ; 如果 列表 不 为 空 ， 就 像 前 面 
的 示例 那样 制作 比 陕 : 


@ _ requested toppings = [] 


@ if requested toppings: 
for requested topping in requested toppings: 
print(f"Adding {requested topping}.") 
print("\nFinished making your pizza!") 
© else: 
print("Are you sure you want a plain pizza?") 


首先 创建 一 个 空 列表 ， 其 中 不 包含 任何 配料 〈 见 @)。 人 处 进行 简 
单 的 检查 ， 而 不 是 直接 执行 for 循环 。 在 if 语句 中 将 列表 名 用 作 
条 件 表达 式 时 ，Python 将 在 列表 至 少 包含 一 个 元 素 时 返回 True ， 

并 在 列表 为 空 时 返回 False 。 如 果 requested_toppings 不 为 空 ， 
就 运行 与 前 一 个 示例 相同 的 for 循环 ;， 否则， 就 打印 一 条 消息 ， 询 
问 顾客 是 否 确实 要 点 不 加 任何 配料 的 原味 比萨 ( 见 @) 。 


在 这 里 ， 这 个 列表 为 空 ， 因 此 输出 如 下 一 一 询问 顾客 是 否 确 实 要 扣 
原味 比萨 : 


Are you sure you want a plain pizza? 


如 果 这 个 列表 不 为 空 ， 输 出 将 显示 在 比萨 中 添加 的 各 种 配料 。 
5.4.3 ”使 用 多 个 列表 


顾客 的 要 求 往往 五 花 八 门 ， 在 比萨 配料 方面 尤其 如 此 。 如 果 顾 客 要 
在 比 院 中 添加 炸 暮 条 ， 该 怎么 办 呢 ? 可 使 用 列表 和 if 语句 来 确定 
能 否 满 足 顾客 的 要 求 。 


来 看 看 在 制作 比萨 前 如 何 拒绝 怪异 的 配料 要 求 。 下 面 的 示例 定义 了 
两 个 列表 ， 其 中 第 一 个 列表 包含 比萨 店 供应 的 配料 ， 而 第 二 个 列表 
包含 顾客 点 的 配料 。 这 次 对 于 requested toppings 中 的 每 个 元 
素 ， 都 检查 它 是 否 是 比萨 店 供应 的 配料 ， 再 决定 是 否 在 比萨 中 添加 
它 : 


@ available toppings = ['mushrooms', 'olives', 'green peppers', 
'pepperoni', 'pineapple', 'extra cheese '] 


@ requested toppings = ['mushrooms', 'french fries', "extra cheese'] 


©@ for requested topping in requested toppings: 

@ if requested topping in available toppings: 
print(f"Adding {requested topping}.") 

© else: 
print(f"Sorry, we don't have {requested topping}.") 


print("\nFinished making your pizzal!") 


@@ 处 定义 了 一 个 列表 ， 其 中 包含 比 陛 店 供应 的 配料 。 请 注意 ， 如 果 
比 酝 店 供应 的 配料 是 固定 的 ， 也 可 使 用 一 个 元 组 来 存储 它们 。 全 处 
又 创建 了 一 个 列表 ， 其 中 包含 顾客 点 的 配料 。 请 注意 那个 不 同 寻 入 


的 配料 一 一 'french fries' 。 在 全 处 裔 历 顾客 点 的 配料 列表 。 在 
这 个 循环 中 ， 对 于 顾客 点 的 每 种 配料 ， 都 检查 它 是 否 包 含 在 供应 的 
配料 列表 中 ( 见 @) 。 如 果 答 案 是 肯定 的 ， 就 将 其 加 入 比萨 中 ， 否 
ee 代码 块 〈 见 @) : 打印 一 条 消息 ， 告 诉 顾客 不 供应 
这 种 配料 。 


这 些 代码 的 输出 整洁 而 翔实 : 


Adding mushrooms. 
Sorry, we don't have french fries. 
Adding extra cheese. 


Finished making your pizzal 


通过 为 数 不 多 的 几 行 代码 ， 我 们 高 效 地 处 理 了 一 种 真实 的 情形 ! 
动手 试 一 斌 


练习 5-8: 以 特殊 方式 跟 管 理 员 打招呼 ”创建 一 个 至 少 包 含 5 
个 用 户 名 的 列表 ， 且 其 中 一 个 用 户 名 为 'admin' 。 想 象 你 要 编 
写 代码 ， 在 每 位 用 户 登录 网 站 后 都 打 印 一 条 问候 消 恩 。 避 历 用 
户 名 列表 ， 并 同 每 位 用 户 打 印 一 条 问候 消息 。 


。 如 果 用 户 名 为 'admin" ， 束 打印 一 条 特殊 的 问候 消 妃 ， 如 
下 所 示 。 


Hello admin, would you like to see a status report? 


。 奋 则 ， 打 印 一 条 普通 的 问候 消 恩 ， 如 下 所 示 。 
Hello Jaden, thank you for logging in again. 
练习 5-9: 处 理 没有 用 户 的 情形 ”在 为 完成 练习 5-8 编 写 的 程序 
中 ， 添 加 一 条 if 语句 ， 检 查 用 户 名 列表 是 否 为 空 。 
。 如 采 为 空 ， 就 打印 如 下 消息 。 


We need to find some users! 


。 删除 列表 中 的 所 有 用 己 名 ， 确 定 将 打印 正确 的 消 妃 。 


练习 5-10: 检查 用 户 名 ” 按 下 面 的 说 明 编 写 一 个 程序 ， 模 拟 
网 站 如 何 确保 每 位 用 户 的 用 户 名 都 独一无二 。 


。 创建 一 个 至 少 包含 5 个 用 户 名 的 列表 ， 并 将 其 命名 
为 current_users。 

。 再 创建 一 个 包含 5 个 用 户 名 的 列表 ， 将 其 命名 
为 new_users ， 并 确保 其 中 有 一 两 个 用 户 名 也 包含 在 列 
表 current_users 中 。 

。 遍历 列表 new_users ， 对 于 其 中 的 每 个 用 户 名 ， 都 检查 它 
是 否 已 被 使 用 。 如 果 是 ， 就 打印 一 条 消息 ， 指 出 需要 输入 
别 的 用 户 名 ; 否则 ， 打 印 一 条 消息 ， 指 出 这 个 用 户 名 未 被 


使 用 。 

确保 比较 时 不 区 分 大 小 写 。 换 句 话 说 ， 如 果 用 户 

名 'John' 已 被 使 用 ， 应 拒绝 用 户 名 'JOHN' 。 (为 此 ， 需 
要 创建 列表 current_users 的 副本 ， 其 中 包含 当前 所 有 
用 户 名 的 小 写 版 本 。) 


练习 5-11: 序数 ”序数 表示 位 置 ， 如 1st 和 2nd。 序 数 大 多 以 了 h 
结尾 ， 只 有 1、2 和 3 例外 。 


。 在 一 个 列表 中 存储 数字 1 一 9。 

。 遍历 这 个 列表 。 

。 在 循环 中 使 用 一 个 1f-elif-else 结构 ， 以 打印 每 个 数字 
对 应 的 序数 。 输 出 内 容 应 为 "1st 2nd 3rd 4th 5th 6th 
7th 8th 9th" ， 但 每 个 序数 都 独占 一 行 。 


5.5 ”设置 if 语句 的 格式 
本 章 的 每 个 示例 都 展示 了 良好 的 格式 设置 习惯 。 在 条 件 测试 的 格式 


设置 方面 ，PEP 8 提供 的 唯一 建议 是 ， 在 诸如 == 、>= 和 <= 等 比较 
运算 符 两 边 各 添加 一 个 空格 。 例 如 : 


这 样 的 空格 不 会 影响 Python 对 代码 的 解读 ， 而 只 是 让 代码 阅读 起 来 
更 容易 。 


练习 5-12: 设置 if 语句 的 格式 审核 你 在 本 草编 写 的 程序 ， 
确保 正确 地 设置 了 条 件 测 试 的 格式 。 


练习 5-13: 自己 的 想法 ”与 刚 拿 起 本 书 时 相 比 ， 现 在 你 是 一 
名 能 力 更 强 的 程序 员 了 。 鉴 于 你 对 如 何在 程序 中 模拟 现实 情形 
有 了 更 深入 的 认识 ， 可 以 考虑 使 用 程序 来 解决 一 些 问 题 了 。 随 
着 编程 技能 不 断 提高 ， 你 可 能 想 解决 一 些 问题 ， 请 将 这 方面 的 
想法 记录 下 来 。 想 想 你 可 能 想 编写 的 游戏 、 想 研究 的 数据 集 以 
及 想 创建 的 Web 应 用 程序 。 


5.6 小结 


在 本 章 中 ， 你 学 习 了 : 如 何 编写 结果 要 么 为 True 要 么 为 False 的 
条 件 测 试 ， 如 何 编写 简单 的 if 语句 、if-else 语句 和 if-elif- 

else 结构 ， 并 且 在 程序 中 使 用 这 些 结构 来 测试 特定 的 条 件 ， 以 确 
定 这 些 条 件 是 否 满足 ， 如 何在 利用 高 效 的 for 循环 的 同时 ， 以 不 同 
于 其 他 元 素 的 方式 对 特定 的 列表 元 素 进 行 处 理 。 你 还 再 次 学 习 了 

Python 就 代码 格式 提出 的 建议 ， 从 而 确保 即便 编写 的 程序 越 来 越 复 
杂 ， 其 代码 依然 易于 阅读 和 理解 。 


在 第 6 章 ， 你 将 学 习 Python 字 典 。 字 典 类 似 于 列表 ， 但 让 你 能 够 将 
不 同 的 信息 关联 起 来 。 你 将 学 习 如 何 创建 和 所 历 字 典 ， 以 及 如 何 将 
字典 同 列表 和 if 语句 结合 起 来 使 用 。 学 习 字 上 典 让 你 能 够 模拟 更 多 
现实 世界 的 情形 。 


在 本 章 中 ， 你 将 学 习 能 够 将 相关 信息 关联 起 来 的 
Python 字典 ， 以 及 如 何 访问 和 修改 字典 中 的 信息 。 字 典 可 存储 
的 信息 量 几 乎 不 受 限制 ， 因 此 我 们 会 演示 如 何人 吉 历 字典 中 的 数 
据 。 另 外 ， 你 还 将 学 习 存 储 字典 的 列表 、 存 储 列表 的 字典 和 存 
储 字典 的 字典 。 


理解 字典 后 ， 就 能 够 更 准确 地 为 各 种 真实 物体 建 模 。 你 可 以 创 
建 一 个 表示 人 的 字典 ， 然 后 想 在 其 中 存储 多 少 信息 就 存储 多 少 
童 轧 : 姓名 、 年 龄 、 地 址 、 职 业 ， 以 及 能 描述 他 的 任何 方面 。 
你 还 能 够 存储 任意 两 种 相关 的 信息 ， 如 一 系列 单词 及 其 含义 ， 
一 系列 人 名 及 其 喜欢 的 数 ， 以 及 一 系列 山脉 及 其 海拔 ， 等 等 。 


6.1 一 个 简单 的 字典 


来 看 一 个 包含 外 星人 的 游戏 ， 这 些 外 星人 的 颜色 和 分 数 各 不 相同 。 
下 面 是 一 个 简单 的 字典 ， 存 储 了 有 关 特 定 外 星人 的 信息 : 


alien.py 


alien 6 = {'color': 'green', 'points': 5} 


print(alien 6['color ']) 


print(alien 6['points ']) 


字典 alien_6 存储 了 外 星人 的 颜色 和 分 数 。 最 后 两 行 代码 访问 并 显 
示 这 些 信 息 ， 结 果 如 下 : 


green 
5 


与 大 多 数 编程 概念 一 样 ， 要 画 练 使 用 字典 ， 也 需要 一 段 时 间 的 练 
习 。 使 用 字典 一 段 时 间 后 ， 你 就 会 明日 为 何 它 们 能 够 高 效 地 模拟 现 
实 世 界 中 的 情形 。 


6.2 ”使 用 字典 


在 Python 中 ， 字 和 典 是 一 系列 键 值 对 。 每 个 键 都 与 一 个 值 相关 联 ， 
你 可 使 用 键 来 访问 相关 联 的 值 。 与 键 相关 联 的 值 可 以 是 数 、 字 符 
和 


在 Python 中 ， 字 典 用 放 在 花 括 号 〈{} ) 中 的 一 系列 键 值 对 表示 ， 如 
前 面 的 示例 所 示 : 


alien 6 = {'color': 'green', 'points': 5} 


键 值 对 是 两 个 相关 联 的 值 。 指 定 键 时 ，Python 将 返回 与 之 相关 联 的 
值 。 键 和 值 之 间 用 冒号 分 隅 ， 而 键 值 对 之 间 用 运 号 分 隔 。 在 字典 
中 ， 想 存储 多 少 个 键 值 对 都 可 以 。 


最 简单 的 字典 只 有 一 个 键 值 对 ， 如 下 述 修改 后 的 字典 alien_8 所 


alien 6 = {'color': 'green'} 


这 个 字典 只 存储 了 一 项 有 关 alien_8 的 信息 ， 具 体 地 说 是 这 个 外 星 
人 的 颜色 。 在 该 字典 中 ， 字 符 串 'color' 是 一 个 键 ， 与 之 相关 联 的 
值 为 'green' 。 


6.2.1 访问 字典 中 的 值 


要 获取 与 键 相 关联 的 值 ， 可 依次 指定 字典 名 和 放 在 方 括号 内 的 键 ， 
如 下 所 示 : 


alien.py 


alien 6 = {'color': 'green'} 


print(alien 6['color ']) 


这 将 返回 字典 alien_6 中 与 键 'color' 相关 联 的 值 : 


green 


字典 中 可 包含 任意 数量 的 键 值 对 。 例 如 ， 下 面 是 最 初 的 字 
典 alien_6 ， 其 中 包含 两 个 键 值 对 : 


alien 6 = { color': 'green', 'points': 5} 


现在 ， 你 可 访问 外 星人 alien_0 的 颜色 和 分 数 。 如 果 玩 家 射 杀 了 这 
个 外 星人 ， 就 可 以 使 用 下 面 的 代码 来 确定 应 获得 多 少 分 : 


alien 6 = {'color': 'green', 'points': 5} 


@ new points = alien 6[ 'points '] 


@ print(f"You just earned {new points} points!") 


上 述 代码 首先 定义 了 一 个 字典 。 然 后 ， 从 这 个 字典 中 获取 与 

键 'points' 相关 联 的 值 ( 见 @) ， 并 将 这 个 值 赋 给 变量 
new_points 。 接 下 来 ， 将 这 个 整数 转换 为 字符 串 ， 并 打印 一 条 消 
尽 ， 指 出 玩家 获得 了 多 少 分 ( 见 @) : 


You just earned 5 points! 


如 果 在 外 星人 被 射 杀 时 运行 这 段 代 码 ， 束 将 获取 该 外 星人 的 分 数 。 
6.2.2 ”添加 键 值 对 


字典 是 一 种 动态 结构 ， 可 随时 在 其 中 添加 键 值 对 。 要 添加 键 值 对 ， 
可 依次 指定 字典 名 、 用 方 括 写 括 起 的 键 和 相关 联 的 值 。 


下 面 来 在 字典 alien_6 中 添加 两 项 信息 : 外 星人 的 z 坐标 和 y 坐 

标 ， 让 我 们 能 够 在 屏幕 的 特定 位 置 显示 该 外 星人 。 我 们 将 这 个 外 星 
人 放 在 屏幕 左边 缘 ， 且 离 屏 幕 顶 部 25 像 素 的 地 方 。 由 于 屏幕 坐标 系 
的 原点 通常 为 左上 角 ， 要 将 该 外 星人 放 在 屏幕 左边 缘 ， 可 将 z 坐标 
设置 为 0， 要 将 该 外 星人 放 在 离 屏 幕 顶 部 25 像 素 的 地 方 ， 可 将 7 坐标 
设置 为 25， 如 下 所 示 : 


alien.py 


alien 6 = {'color': 'green', 'points': 5} 
print(alien 6) 


@ alien 8['x position'] = 6 
@ alien 6['y_position'] = 25 
print(alien 6) 


首先 定义 前 面 一 直 在 使 用 的 字典 ， 然 后 打印 这 个 字典 ， 以 显示 其 信 

恩 快 照 。 在 @@ 处 ， 我 们 在 这 个 字典 中 新 增 了 一 个 键 值 对 ， 其 中 的 键 

为 'x_position' ， 值 为 0。 在 他 处 重复 这 样 的 操作 ， 但 使 用 的 键 

a 。 打 印 修改 后 的 字典 时 ， 将 看 到 这 两 个 新 增 的 键 
xX: 


{'color': 'green', 'points': 5} 
{'color': 'green', 'points': 5, 'y_position': 25, 'x position': 6} 


这 个 字典 的 最 终 版 本 包含 四 个 键 值 对 : 原来 的 两 个 指定 外 星人 的 闫 
色 和 分 数 ， 而 新 增 的 两 个 指定 其 位 置 。 


注意 ”在 Python 3.7 中 ， 字 典 中 元 素 的 排列 顺序 与 定义 时 相 
同 。 如 果 将 字典 打印 出 来 或 过 历 其 元 么 ， 将 发 现 元 素 的 排列 顺 
序 与 添加 顺序 相同 。 


6.2.3” 先 创建 一 个 空 字典 

在 空 字典 中 添加 键 值 对 有 时 候 可 提供 便利 ， 而 有 时 候 必 须 这 样 做 。 
为 此 ， 可 先 使 用 一 对 空 花 括 号 定义 一 个 字典 ， 再 分 行 添加 各 个 键 值 
对 。 例 如 ， 下 面 演示 了 如 何以 这 种 方式 创建 字典 alien_6 : 


alien.py 


alien 6 = {} 


alien 6['color'] = 'green' 
alien 6[ 'points '] = 5 


print(alien 6) 


这 里 首先 定义 了 空 字典 alien_8 ， 再 在 其 中 添加 颜色 和 分 数 ， 得 到 
前 述 示例 一 直 在 使 用 的 字典 : 


{'color': 'green', 'points': 5} 


使 用 字典 来 存储 用 户 提 供 的 数据 或 在 编写 能 自动 生成 大 量 键 值 对 的 
代码 时 ， 通 前 需要 先 定义 一 个 空 字典 。 


6.2.4 修改 字典 中 的 值 
要 修改 字典 中 的 值 ， 可 依次 指定 字典 名 、 用 方 括号 括 起 的 键 ， 以 及 


与 该 键 相 关联 的 新 值 。 例 如 ,假设 随 看 游戏 的 进行 ， 震 要 将 一 个 外 
星人 从 绿色 改 为 黄色 : 


alien.py 


alien 6 = {'color': 'green'} 
print(f"The alien is {alien 8['color']}.") 


alien 6['color'] = "yellow 
print(f"The alien is now {alien ee['color']}.") 


首先 定义 一 个 表示 外 星人 alien_8 的 字典 ， 其 中 只 包含 这 个 外 星人 
的 颜色 。 接 下 来 ， 将 与 键 'color' 相关 联 的 值 改 为 'yellow' 。 输 
出 表明 ， 这 个 外 星人 确实 从 绿色 变 成 了 黄色 : 


The alien is green. 
The alien is now yellow. 


来 看 一 个 更 有 趣 的 例子 ， 对 一 个 能 够 以 不 同 速度 移动 的 外 星人 进行 
位 置 跟踪 。 为 此 ， 我 们 将 存储 该 外 星人 的 当前 速度 ， 并 据 此 确定 该 
外 星人 将 疝 厂 移动 多 远 : 


alien 6 = {'x_ position': 8, 'y_position': 25, 'speed': 
print(f"Original position: {alien 6['x_position']}") 


# 回 右 移动 外 星人 。 
# 根据 当前 速度 确定 将 外 星人 向 右 移动 多 远 。 
@ if alien 6[' speed'] == 'slow': 
x_increment = 1 
elif alien 6['speed '] 
x_increment = 2 


els 


e. 
# 这 个 外 星人 的 移动 速度 肯定 很 快 。 


x_increment = 3 


# 新 位 置 为 旧 位 置 加 上 移动 距离 。 


@ alien 8['x position'] = alien ©8['x_ position'] + x_increment 


print(f"New position: {alien 8['x_ position']}") 


首先 定义 一 个 外 星人 ， 其 中 包含 初始 z 坐标 和 y 坐标 ， 还 有 速 

度 'medium"。 出 于 简化 考虑 ， 省 略 了 颜色 和 分 数 ， 但 即便 包含 这 
些 键 值 对 ， 本 例 的 工作 原理 也 不 会 有 任何 变化 。 我 们 还 打印 了 
x_position 的 初始 值 ， 骨 在 让 用 户 知道 这 个 外 星人 同 右 移动 了 多 
远 。 


QO 处 使 用 一 个 if-elif-else 结构 来 确定 外 星人 应 向 右 移动 多 远 ， 
并 将 这 个 值 赋 给 变量 x_increment 。 如 果 外 星人 的 速度 为 "slow' 
， 它 将 同 厂 移动 一 个 单位 ; 如果 速度 为 "medium' ， 将 问 右 移 动 两 
个 单位 ; 如 果 为 'fast' ， 将 同 右 移动 三 个 单位 。 确定 移动 距离 
后 ， 将 其 与 x_position 的 当前 值 相 加 ( 见 @) ， 再 将 结果 关联 到 
字典 中 的 键 x _position 。 


因为 这 是 一 个 速度 中 等 的 外 星人 ， 所 以 其 位 置 将 向 右 移 两 个 单位 : 


Original x-position: 6 
New x-position: 2 


这 种 技术 很 棒 : 通过 修改 外 星人 字典 中 的 值 ， 可 改变 外 星人 的 行 
为 。 例 如 ， 要 将 这 个 速度 中 等 的 外 星人 变 成 速度 很 快 的 外 星人 ， 可 
添加 如 下 代码 行 : 


alien 6['speed'] = 'fast' 


这 样 ， 再 次 运行 这 些 代码 时 ， 其 中 的 if-elif-else 结构 将 把 一 个 
更 大 的 值 赋 给 变量 x_increment 。 


6.2.5 ”删除 键 值 对 


对 于 字典 中 不 再 再 要 的 信息 ， 可 使 用 del 语句 将 相应 的 键 值 对 彻底 
删除 。 使 用 del 语句 时 ， 必 须 指定 字典 名 和 要 删除 的 键 。 


例如 ， 下 面 的 代码 从 字典 alien_68 中 删除 键 'points' 及 其 值 : 


alien.py 


alien 6 = {'color': 'green', 'points': 5} 
print(alien 6) 


@ del alien 8['points'] 
print(alien 6) 


[L | 


@@ 处 的 代码 行 让 Python 将 键 'points' 从 字典 alien_68 中 删除 ， 同 
时 删除 与 这 个 键 相关 联 的 值 。 输 出 表明 ， 键 'points' 及 其 值 5 已 
从 字典 中 删除 ， 但 其 他 键 值 对 未 受 影响 : 


'": 'green', 'points': 5} 
': 'green'} 


注意 ”删除 的 键 值 对 会 永远 消失 。 
6.2.6 ”由 类 似 对 象 组 成 的 字典 


在 前 面 的 示例 中 ， 字 典 存储 的 是 一 个 对 象 ( 游 戏 中 的 一 个 外 星人 ) 
的 多 种 信息 ， 但 你 也 可 以 使 用 字典 来 存储 众多 对 象 的 同一 种 信息 。 
例如 ， 假 设 你 要 调查 很 多 人 ， 询 问 他 们 最 喜欢 的 编程 语言 ， 可 使 用 
一 个 字典 来 存储 这 种 简单 调查 的 结 末 ， 如 下 所 示 : 


favorite languages = { 
'jen': 'python', 
"sarah': 'c', 
"edward': 'ruby', 


"phil': 'python', 
} 


如 你 所 见 ， 我 们 将 一 个 较 大 的 字典 放 在 了 多 行 中 。 每 个 键 都 是 一 个 
被 调查 者 的 名 字 ， 而 每 个 值 都 是 被 调查 者 辟 欢 的 语言 。 确 定 需要 使 
用 多 行 来 定义 字典 时 ， 要 在 输入 左 花 括号 后 按 回 车 键 。 在 下 一 行 缩 
进 四 个 空格 ， 指 定 第 一 个 键 值 对 ， 并 在 它 后 面 加 上 一 个 逗号 。 此 后 
再 按 回 车 键 时 ， 文 本 编辑 器 将 目 动 缩 进 后 续 键 值 对 ， 且 缩 进 量 与 第 
一 个 键 值 对 相同 。 


定义 好 字典 后 ， 在 最 后 一 个 键 值 对 的 下 一 行 添 加 一 个 右 花 括号 ， 并 
缩 进 四 个 空格 ， 使 其 与 字典 中 的 键 对 齐 。 一 种 不 错 的 做 法 是 ， 在 最 
后 一 个 键 值 对 后 面 也 加 上 逗号 ， 为 以 后 在 下 一 行 添加 键 值 对 做 好 准 


备 。 


注意 ”对 于 较 长 的 列表 和 字典 ， 大 多 数 编辑 器 提供 了 以 类 似 
方式 设置 格式 的 功能 。 对 于 较 长 的 字典 ， 还 有 其 他 一 些 可 行 的 
格式 设置 方式 ， 因 此 在 你 的 编辑 器 或 其 他 源 代码 中 ， 你 可 能 会 
看 到 稍微 不 同 的 格式 设置 方式 。 


给 定 被 调查 者 的 名 字 ， 可 使 用 这 个 字典 轻松 地 获悉 他 喜欢 的 语言 : 


favorite_languages.py 


favorite languages = { 
'jen': 'python', 
'sarah': 'c', 
"edward': 'ruby', 
"phil': 'python', 


@ language = favorite languages['sarah'].title() 
print(f"Sarah's favorite language is {language}.") 


为 获悉 Sarah 喜 欢 的 语言 ， 我 们 使 用 如 下 代码 : 


favorite languages['sarah'] 


在 @ 处 ， 使 用 这 种 语法 获取 Sarah 喜 欢 的 语言 ， 并 将 其 赋 给 变量 
language 。 创 建 这 个 新 变量 让 函数 调用 print() 变 得 整洁 得 多 。 
输出 指出 了 Sarah 喜 欢 的 语言 : 


Sarah's favorite language is C. 


这 种 语法 可 用 来 从 字典 中 获取 任何 人 喜欢 的 语言 。 
6.2.7 使 用 get() 来 访问 值 


使 用 放 在 方 括 与 内 的 键 从 字典 中 获取 感 兴趣 的 值 时 ， 可 能 会 引发 问 
题 : 如 琳 指 定 的 键 不 存在 就 会 出 错 。 


如 果 你 要 求 获取 外 星人 的 分 数 ， 而 这 个 外 星人 没有 分 数 ， 结 果 将 如 
何 呢 ? 下 面 来 看 一 看 : 


alien_no_points.py 


alien 6 = {'color': 'green', 'speed': 'slow'} 
print(alien 6['points']) 


这 将 导致 Python 显示 traceback， 指 出 存在 键 值 错误 〈KeyError 
) : 


Traceback (most recent call last): 
File "alien no points.py", line 2, in <module> 
print(alien 6['points']) 
KeyError: 'points'" 


第 10 章 将 详细 介绍 如 何 处 理 类 似 的 错误 ， 但 就 字典 而 言 ， 可 使 用 方 
法 get() 在 在 指 定 的 键 不 存在 时 返 回 一 个 默认 值 ， 从 而 避免 这 样 的 错 
误 。 


方法 get () 的 第 一 个 参数 用 于 指定 键 ， 是 必 不 可 少 的 ; 第 二 个 参数 
为 指定 的 键 不 存在 时 要 返回 的 值 ， 是 可 选 的 : 


alien 6 = {'color': 'green', 'speed': 'slow'} 


point value = alien 6.get('points'， 'No point value assigned.') 


print(point value) 


如 果 字 上 典 中 有 和 键 'points' ， 将 获得 与 之 相关 联 的 值 ; 如 朱 没 有 ， 
将 获得 指定 的 默认 值 。 虽 然 这 里 没有 键 'points' ， 但 将 获得 一 条 
清晰 的 消息 ， 不 会 引发 错误 : 


No point value assigned . 


如 琳 指 定 的 键 有 可 能 不 存在 ， 应 考虑 使 用 方法 get() ， 而 不 要 使 用 
方 括 写 表示 法 。 


注意 ”调用 get() 时 ， 如 果 没 有 指定 第 二 个 参数 且 指 定 的 键 
不 存在 ，Python 将 返回 值 None 。 这 个 特殊 值 表 示 没 有 相应 的 
值 。None 并 非 错误 ， 而 是 一 个 表示 所 需 值 不 存在 的 特殊 值 ， 
第 8 章 将 介绍 它 的 其 他 用 途 。 


动手 试 一 斌 


练习 6-1: 人 使 用 一 个 字 — 典 来 存储 一 个 熟人 的 信息 ， 包 括 
名 、 姓 、 年 龄 和 居住 的 城市 。 该 字典 应 包含 键 first_name 
、1last_name 、age 和 city 。 将 存储 在 该 字典 中 的 每 项 信息 
都 打印 出 来 。 


练习 6-2: 喜欢 的 数 “” 使 用 一 个 字典 来 存储 一 些 人 喜欢 的 数 。 

请 想 出 5 个 人 的 名 字 ， 并 将 这 些 名 字 用 作 字 典 中 的 键 ， 找 出 每 
个 人 喜欢 的 一 个 数 ， 并 将 这 些 数 作为 值 存 储 在 字典 中 。 打 印 每 
个 人 的 名 字 和 喜欢 的 数 。 为 了 让 这 个 程序 更 有 趣 ， 通 过 询问 朋 
友 确保 数据 是 真实 的 。 


练习 6-3: 词汇 表 “Python 字典 可 用 于 模拟 现实 生活 中 的 字 
典 。 为 避免 混 消 ， 我 们 将 后 者 称 为 词汇 表 。 


。 想 出 你 在 前 面 学 过 的 5 个 编程 术语 ， 将 其 用 作词 汇 表 中 的 
键 ， 并 将 它们 的 含义 作为 值 存储 在 词汇 表 中 。 

。 以 整洁 的 方式 打印 每 个 术语 及 其 含义 。 为 此 ， 可 先 打印 术 
语 ， 在 它 后 面 加 上 一 个 冒 写 ， 再 打印 其 含义 ; 也 可 在 一 行 
打印 术语 ， 再 使 用 换行 符 (\n ) 插入 一 个 空 行 ， 然 后 在 
下 一 行 以 缩 进 的 方式 打印 其 含义 。 


6.3 遍历 字典 


一 个 Python 字 典 可 能 只 包含 几 个 键 值 对 ， 也 可 能 包含 数 百 万 个 键 值 
对 。 鉴 于 字典 可 能 包含 大 量 数 据 ， ea 
典 可 用 于 以 各 种 方式 存储 信息 ， 因 此 有 多 种 遍历 方式 : 可 遍历 字典 
的 所 有 键 值 对 ， 也 可 仅 遍 历 键 或 值 。 


6.3.1 过 历 所 有 键 值 对 


0 局 历 方法 前 ， 先 来 看 一 个 新 字典 ， 它 用 于 存储 有 关 网 站 用 
户 的 信息 。 下 面 的 字典 存储 一 名 用 户 的 用 户 名 、 名 和 姓 : 


user 6 = { 
'username': "efermi '， 
"first': 'enrico', 


"last': 'fermi', 


} 


利用 本 章 前 面 介 绍 过 的 知识 ， 可 访问 user 0 的 任何 :项 信息 心 \ » 但 
如 果 要 获悉 该 用 户 字典 中 的 所 有 信息 ， 该 而 何 办 呢 ? 可 使 用 for 第 
环 来 授 历 这 个 字典 : 


user.py 


user ©={ 
'uUsername': 'efermi', 
'first': 'enrico', 
"last': 'fermi', 


@ for key, value in user 6.items() : 
@ print(f"\nKey: {key}") 
3 print(f"Value: {value}") 


如 人 @ 所 示 ， 要 编写 裔 历 字 典 的 for 循环 ， 可 声明 两 个 变量 ， 用 于 存 


储 键 值 对 中 的 键 和 值 。 这 两 个 变量 可 以 使 用 任意 名 称 。 下 面 的 代码 
使 用 了 简单 的 变量 名 ， 这 完全 可 行 : 


for k, v in user 6.items() 


for 语句 的 第 二 部 分 包含 字典 名 和 方法 items() 〈 见 @) ， 它 返回 
一 个 键 值 对 列表 。 接 下 来 ，for 循环 依次 将 每 个 键 值 对 赋 给 指定 的 
两 个 变量 。 在 本 例 中 ， 使 用 这 两 个 变量 来 打印 每 个 键 〈 见 外) 及 其 
相关 联 的 值 ( 见 @) 。 第 一 个 函数 调用 print() 中 的 "\n" 确保 在 
输出 每 个 键 值 对 前 都 插入 一 个 空 行 : 


Key: username 
Value: efermi 


Key: first 
Value: enrico 


Key: last 
Value: fermi 


在 6.2.6 节 的 示例 favorite_languages.py 中 ， 字 典 存 储 的 是 不 同人 的 同 
一 种 信息 。 对 于 类 似 这 样 的 字典 ， 裔 历 所 有 的 键 值 对 很 合适 。 如 果 
通 历 字 典 favorite _languages ， 将 得 到 其 中 每 个 人 的 姓名 和 喜欢 
的 编程 语言 。 由 于 该 字典 中 的 键 都 是 人 名 ， 值 都 是 语言 ， 因 此 在 循 
环 中 使 用 变量 name 和 1language ， 而 不 是 key 和 value 。 这 让 人 更 
容易 明白 循环 的 作用 : 


favorite_languages.py 


favorite languages = { 
'jen': 'python', 
'sarah': 'c', 
‘edward': 'ruby', 
"phil': 'python', 


@ for name, language in favorite languages.items(): 


@ print(f"{name.title()}'s favorite language is {language.title()} 


@@ 处 的 代码 让 Python 人 遍历 字典 中 的 每 个 键 值 对 ， 并 将 键 赋 给 变量 
name ， 将 值 赋 给 变量 language 。 这 些 描述 性 名 称 能 够 让 人 非常 轻 
松 地 明白 函数 调用 print() ( 见 @) 是 做 什么 的 。 


仅 使 用 几 行 代码 ， 就 将 全 部 调查 结果 显示 出 来 了 : 


Jen's favorite language is Python. 
Sarah's favorite language is C. 
Edward's favorite language is Ruby . 


Phil's favorite language is Python . 


即便 字典 存储 的 是 上 干 乃 至 上 百 万 人 的 调查 结果 ， 这 种 循环 也 省 
用 。 


6.3.2” 通 历 字典 中 的 所 有 键 


在 不 需要 使 用 字典 中 的 值 时 ， 方 法 keys() 很 有 用 。 下 面 来 遍历 字 
典 favorite_languages ， 并 将 每 个 被 调查 者 的 名 字 都 打印 出 来 : 


favorite languages = { 
'jen': 'python', 
'sarah': 'c', 
"edward': 'ruby', 
"phil': 'python', 


@ for name in favorite languages.keys(): 
print(name.title()) 


@ 处 的 代码 行 让 Python 提 取 字 典 favorite_languages 中 的 所 有 
键 ， 并 依次 将 它们 赋 给 变量 name 。 输 出 列 出 了 每 个 被 调查 者 的 名 
字 : 


思 历 字典 时 ， 会 默认 遇 历 所 有 的 键 。 因 此 ， 如 果 将 上 述 代码 中 的 : 


for name in favorite languages: 


答 换 为 : 


for name in favorite languages.keys(): 


输出 将 不 变 。 


显 式 地 使 用 方法 keys() 可 让 代码 更 容易 理解 ， 你 可 以 选择 这 样 
做 ， 但 是 也 可 以 省 略 它 。 


在 这 种 循环 中 ， 可 使 用 当前 键 来 访问 与 之 相关 联 的 值 。 下 面 来 打印 
两 条 消息 ， 指 出 两 位 朋友 喜欢 的 语言 。 像 前 面 一 样 遍历 字典 中 的 名 
字 ， 但 在 名 字 为 指定 朋友 的 名 字 时 ， 打 印 一 条 消息 ， 指 出 其 喜欢 的 


favorite languages = { 
--Snip-- 


} 


@ friends = ['phil', 'sarah'] 
for name in favorite languages.keys(): 


print(f"Hi {name.title()}.") 


if name in friends: 
language = favorite languages[namel].title() 
print(f"\t{name.title()}, I see you love {language}!") 


@@ 处 创建 了 一 个 列表 ， 其 中 包含 要 收 到 打印 消 恩 的 朋友 。 在 循环 
中 ， 打 印 每 个 人 的 名 字 ， 并 检查 当前 的 名 字 是 否 在 列表 friends 中 
( 见 人 @) 。 如 果 在 ， 就 打印 一 句 特殊 的 问候 语 ， 其 中 包含 这 位 朋友 
喜欢 的 语言 。 为 获悉 朋友 喜欢 的 语言 ， 我 们 使 用 了 字典 名 ， 并 将 变 
量 name 的 当前 值 作 为 键 〈 见 合 ) 。 


每 个 人 的 名 字 痢 会 被 打印 ， 但 只 对 朋友 打 特 殊 消息 : 


Hi Jen. 
Hi Sarah. 

Sarah, I see you love C! 
Hi Edward. 


Hi Phil. 
Phil, I see you love Python! 


还 可 使 用 方法 keys() 确定 某 个 人 是 否 接 受 了 调查 。 下 面 的 代码 确 
定 Erin 是 否 接受 了 调查 : 


favorite languages = { 
'jen': 'python', 
'sarah': 'c', 
"edward': 'ruby', 
"phil': "python '， 
} 


@ if 'erin' not in favorite languages.keys(): 
print("Erin, please take our poll!") 


方法 keys() 并 非 只 能 用 于 遍历 :实际 上 ， 它 返回 一 个 列表 ， 其 中 

含 字 典 中 的 所 有 键 。 因 此 全 处 的 代码 行 只 核实 "erin' 是 否 包含 
在 这 个 列表 中 。 因 为 她 并 不 包含 在 这 个 列表 中 ， 所 以 打印 一 条 消 
晨 ， 邀 请 她 参加 调 仁 : 


Erin, please take our poll! 


6.3.3 ” 按 特 定 顺序 过 历 字典 中 的 所 有 键 


从 Python 3.7 起 ， 明 历 字 典 时 将 按 插 入 的 顺序 返回 其 中 的 元 素 。 不 
过 在 有 些 情况 下 ， 你 可 能 要 按 与 此 不 同 的 顺序 名 历 字 典 。 


要 以 特定 顺序 返回 元 素 ， 一 种 办 法 是 在 for 循环 中 对 返回 的 键 进行 
a 
副本 : 


favorite languages = { 
'jen': 'python', 
"sarah': 'c', 
"edward': 'ruby', 
"phil': 'python', 


} 


for name :in sorted(favorite languages.keys()): 
print(f"{name.title()}, thank you for taking the poll.") 


这 条 for 语句 类 似 于 其 他 for 语句 ， 不 同 之 处 是 对 方法 
dictionary .keys() 的 结果 调用 了 函数 sorted() 。 这 让 Python 列 
出 字典 中 的 所 有 键 ， 并 在 遍历 前 对 这 个 列表 进行 排序 。 输 出 表明 ， 
按 顺 序 显 示 了 上 所 有 被 调查 者 的 名 字 : 


Edward，thank you for taking the poll. 
Jen, thank you for taking the poll. 
Phil, thank you for taking the poll. 


Sarah, thank you for taking the poll. 


6.3.4 ”人 授 历 字典 中 的 所 有 值 


如 果 主 要 对 字典 包含 的 值 感 兴趣 ， 可 使 用 方法 values() 来 返回 一 
个 值 列表 ， 不 包含 任何 键 。 例 如 ,假设 我 们 想 获得 一 个 列表 ， 其 中 
ER 
这 样 做 : 


favorite languages = 
'jen': 'python', 
"sarah': 'c', 
"edward': 'ruby', 
"phil': 'python', 
} 


print("The following languages have been mentioned:") 
for language in favorite languages.values(): 
print(language.title()) 


这 条 for 语句 提取 字典 中 的 每 个 值 ， 并 将 其 依次 赋 给 变量 
language 。 通 过 打印 这 些 值 ， 就 获得 了 一 个 包含 被 调查 者 所 选择 
语言 的 列表 : 


The following languages have been mentioned: 
Python 

C 

Ruby 

Python 


这 种 做 法 提取 字典 中 所 有 的 值 ， 而 没有 考虑 是 售 重 复 。 涉 及 的 值 很 
少时 ， 这 也 许 不 是 问题 ， 但 如 打 被 调查 者 很 多 ， 最 终 的 列表 可 能 

含 大 量 重复 项 。 为 吻 除 重复 项 ， 可 使 用 集合 (set〉。 集 合 中 的 每 
个 元 素 都 必须 是 独一无二 的 : 


favorite languages 
--Snip-- 


} 


print("The following languages have been mentioned:") 


@ for language in set(favorite languages.values()): 
print(language.title()) 


通过 对 包含 重复 元 素 的 列表 调用 set() ， 可 让 Python 找 出 列表 中 独 
一 无 二 的 元 素 ， 并 使 用 这 些 元 素来 创建 一 个 集合 。@ 处 使 用 set() 


来 提取 favorite_ languages.values() 中 不 同 的 语言 。 
结 末 是 一 个 不 重复 的 列表 ， 其 中 列 出 了 被 调查 者 提 及 的 所 有 语言 : 


The following languages have been mentioned : 
Python 
C 


Ruby 


随 着 你 更 深入 地 学 习 Python， 经 常会 友 现 它 内 置 的 功能 可 帮助 你 以 
希望 的 方式 处 理 数据 。 


0 
隅 元 系 : 


>>> languages = {'python', 'ruby', "python " ， 'c'} 
>>> languages 


{'ruby', 'python', 'c'} 


集合 和 字典 很 容易 混 消 ， 因 为 它们 都 是 用 一 对 人 花 括 号 定义 的 。 
当 花 括号 内 没有 键 值 对 时 ， 定 义 的 很 可 能 是 集合 。 不 同 于 列表 
和 和 字典， 集合 不 会 以 特定 的 顺序 存储 元 系 。 


动手 试 一 斌 


练习 6-4: 词汇 表 2 ”现在 你 知道 了 如 何 遍 历 字 典 ， 可 以 整理 为 
完成 练习 6-3 而 编写 的 代码 ， 将 其 中 的 一 系列 函数 调用 print() 
替换 为 一 个 遍历 字典 中 键 和 值 的 循环 。 确 定 该 循环 正确 无 误 

后 ， 再 在 词汇 表 中 添加 5 个 Python 术语 。 当 你 再 次 运行 这 个 程 

序 时 ， 这 些 新 术语 及 其 含义 将 自动 包含 在 输出 中 。 


练习 6-5: 河流 ”创建 一 个 字典 ， 在 其 中 存储 三 条 重要 河流 及 
其 流 经 的 国家 。 例 如 ， 一 个 键 值 对 可 能 是 'nile': “egypt' 


。 使 用 循环 为 每 条 河流 打印 一 条 消息 ， 下 面 是 一 个 例子 。 


The Nile runs through Egypt. 


。 使 用 循环 将 该 字典 中 每 条 河流 的 名 字 打 印 出 来 。 
。 使 用 循环 将 该 字典 包含 的 每 个 国家 的 名 字 打 印 出 来 。 


练习 6-6: 调查 ”在 6.3.1 节 编写 的 程序 favorite_languages.py 中 
执行 以 下 操作 。 


。 创建 一 个 应 该 会 接受 调查 的 人 员 名 单 ， 其 中 有 些 人 已 包含 
在 字典 中 ， 而 其 他 人 未 包含 在 字典 中 。 

。 遍历 这 个 人 员 名 单 。 对 于 已 参与 调查 的 人 ， 打 印 一 条 消息 
表示 感谢 ， 对 于 还 未 参与 调查 的 人 ， 打 印 一 条 消息 邀请 他 


参加 。 


6.4 冉 套 


有 了 时候， 需要 将 一 系列 字典 存储 在 列表 中 ， 或 将 列表 作为 值 存储 在 
字典 中 ， 这 称 为 甬 套 。 你 可 以 在 列表 中 拨 套 人 字典、 在 字典 中 绊 套 
列表 甚至 在 字典 中 购 僚 字典 。 正 如 下 面 的 示例 将 演示 的 ， 赔 僚 是 一 
项 强大 的 功能 。 


6.4.1 字典 列表 


字典 alien_6 包含 一 个 外 星人 的 各 种 信息 ， 但 无 法 存储 第 二 个 外 星 
人 的 信息 ， 更 别 说 屏 硕 上 全 部 外 星人 的 信息 了 。 如 何 窟 理 成 群 结 队 
的 外 星人 呢 ? 一 种 办 法 是 创建 一 个 外 星人 列表 ， 其 中 每 个 外 星人 都 
古 一 个 字典 ， 包 含有 关 该 外 星人 的 各 种 信息 。 例 如 ， 下 面 的 代码 创 
建 一 个 包含 三 个 外 星人 的 列表 : 


aliens.py 


alien 6 = {'color': 'green', 'points': 5} 
alien 1 = {'color': 'yellow', 'points': 106} 
alien 2 = {'color': 'red', 'points': 15} 


@ aliens = [alien 68, alien 1, alien 2] 


for alien in aliens: 
print(alien) 


首先 创建 三 个 字典 ， 其 中 每 个 字 — 典 都 表示 一 个 外 星人 。 然 后 在 @ 处 
将 这 些 字典 都 存储 到 一 个 名 为 aliens 的 列表 中 。 最 后 ， 遍 历 这 个 
列表 ， 并 将 每 个 外 星人 都 打印 出 来 : 


{'color': 'green', 'points': 5} 
{'color': 'yellow', 'points': 16} 


{'color': 'red', 'points': 15} 


更 符合 现实 的 情形 是 ， 外 星人 不 止 三 个 ， 且 每 个 外 星人 都 是 使 用 代 
人 


# 创建 一 个 用 于 存储 外 星人 的 空 列 表 。 


aliens = [] 


# 创建 36 个 绿色 的 外 星人 。 
@ for alien number in range(36) : 
@ new_alien = {'color': 'green', 'points': 5, 'speed': 'slow'} 
3) aliens.append(new alien) 


# 显示 前 5 个 外 星人 。 
@ for alien in aliens[:5]: 
print(alien) 
print("...") 


# 显示 创建 了 多 少 个 外 星人 


© print(f"Total number of aliens: {len(aliens)}") 


在 本 例 中 ， 首 先 创建 一 个 空 列表 ， 用 于 存储 接 下 来 将 创建 的 所 有 外 
星人 。 在 @ 处 ，range() 返回 一 系列 数 ， 其 唯一 的 用 途 是 告诉 
Python 要 重复 这 个 循环 多 少 次 。 每 次 执行 这 个 循环 时 ， 都 创建 一 个 
外 星人 【〔 见 人 @) ， 并 将 其 附加 到 列表 aliens 末尾 ( 见 @) .在 @@ 
处 ， 使 用 一 个 切片 来 打印 前 5 个 外 星人 。 在 全 处 ， 打 印 列表 的 长 
度 ， 以 证 明确 实 创建 了 30 个 外 星人 : 


'green', 'points': 
'green', 'points': 
'green', 'points': 
'green', 'points': 
'green', 'points': 


Total number of aliens: 30 


这 些 外 星人 都 具有 相同 的 特征 ， 但 在 Python 看 来 ， 每 个 外 星人 都 是 
独立 的 ， 这 让 我 们 能 够 独立 地 修改 每 个 外 星人 。 


在 什么 情况 下 需要 处 理 成 群 结 队 的 外 星人 呢 ? 想象 一 人 下， 可 能 随 着 
游戏 的 进行 ， 有 些 外 星人 会 变色 且 加 快 移动 速度 。 必 要 时 ， 可 使 
用 for 循环 和 if 语句 来 修改 某 些 外 形 人 的 颜色 。 例 如 ， 要 将 前 三 
个 外 星人 修改 为 黄色 、 速 度 为 中 等 且 值 10 分 ， 可 这 样 做 : 


# 创建 一 个 用 于 存储 外 星人 的 空 列 表 。 


alien 


# 创建 36 个 绿色 的 外 星人 。 

for alien_number in range (36) : 
new alien = {'color': 'green', 'points': 5, 'speed': 'slow'} 
aliens.append(new alien) 


for alien in aliens[:3]: 
if alien['color'] == 'green': 


alien[ "color '] "yellow' 
alien['speed'] “medium 
alien[ ' "points '] = 16 


# 显示 前 5 个 外 星人 。 

for alien in aliens[:5]: 
print(alien) 

print("...") 


鉴于 要 修改 前 三 个 外 星人 ， 我 们 遍历 一 个 只 包含 这 些 外 星人 的 切 
片 。 当 前 ， 所 有 外 星人 都 是 绿色 的 ， 但 情况 并 非 总 是 如 此 ， 因 此 编 
写 一 条 if 语句 来 确保 只 修改 绿色 外 星人 。 如 果 外 星人 是 绿色 的 ， 
就 将 其 颜色 改 为 "yellow' ， 将 其 速度 改 为 "medium' ， 并 将 其 分 
数 改 为 16 ， 如 下 面 的 输出 所 示 : 


'yellow', 'points': 16， 'speed': 'medium'} 
'yellow', 'points': 16， 'speed': 'medium'} 
'yellow', 'points': 16， 'speed': 'medium'} 
'green', 'points': 5, 'speed': 'slow'} 


'green', 'points': 5, 'speed': 'slow'} 


可 进一步 扩展 这 个 循环 ， 在 其 中 添加 一 个 elif 代码 块 ， 将 黄色 外 
星人 改 为 移动 速度 快 且 值 15 分 的 红色 外 星人 ， 如 下 所 示 《〈 这 里 只 列 


出 了 循环 ， 而 没有 列 出 整个 程序 ) : 


for alien in aliens[6:3]: 
if alien['color'] == 'green': 
alien['color'] = "yellow 
alien[ speed'] = "medium' 
alien['points'] = 16 


elif alien['color'] == "yellow ': 
alien['color'] = “Fred' 
alien[ "speed '] = 'fast' 
alien[ ' "points '] = 15 


经 常 需要 在 列表 中 包含 大 量 的 字典 ， 而 其 中 每 个 字典 都 包含 特定 对 
象 的 众多 信息 。 例 如 ， 你 可 能 需要 为 网 站 的 每 个 用 户 创建 一 个 字典 
( 束 像 6.3.1 节 的 user.py 中 那样 )， 并 将 这 些 字 典 存储 在 一 个 名 
为 users 的 列表 中 。 在 这 个 列表 中 ， 所 有 字典 的 结构 都 相同 ， 因 此 
你 可 以 遇 历 这 个 列表 ， 并 以 相同 的 方式 处 理 其 中 的 每 个 字典 。 


6.4.2 ”在 字典 中 存储 列表 


有 时 候 ， 需 要 将 列表 存储 在 字典 中 ， 而 不 是 将 字典 存储 在 列表 中 。 

例如 ， 你 如 何 描述 顾客 点 的 比 工 呢 ? 如 果 使 用 列表 ， 只 能 存储 要 添 

人 Se i 就 不 仅 可 在 其 中 包含 配料 列表 ， 
可 包含 其 他 有 关 比 院 的 描述 


在 下 面 的 示例 中 ， 存 储 了 比萨 的 两 方面 信息 : 外 皮 类 型 和 配料 列 
表 。 配 料 列表 是 一 个 与 键 "toppings' 相关 联 的 值 。 要 访问 该 列 
表 ， 我 们 使 用 字典 名 和 键 "'toppings' ， 就 像 访问 字典 中 的 其 他 值 
一 样 。 这 将 返回 一 个 配料 列表 ， 而 不 是 单个 值 : 


pizza.py 


# 存储 所 点 比萨 的 信息 。 
@ pizza = { 
'crust': 'thick', 
'toppings': ['mushrooms', 'extra cheese'|], 


# 概述 所 点 的 比萨 。 


@ print(f"You ordered a {pizza[ "crust']}-crust pizza " 
"with the following toppings:") 


@ for topping in pizza[ 'toppings '] : 
print("\"f+topping) 


首先 创建 一 个 字典 ， 其 中 存储 了 有 关 顾 客 所 点 比萨 的 信息 ( 见 
@) . 在 这 个 字典 中 ， 一 个 键 是 'crust' ， 与 之 相关 联 的 值 是 字符 
串 'thick' ; 下 一 个 键 是 'toppings' ， 与 之 相关 联 的 值 是 一 个 列 
表 ; 其 其 中 存储 了 顾客 要 求 添加 的 所 有 配料 。 制 作 前 ， 我 们 概述 了 顾 
客 所 点 的 比萨 〈 见 @) 。 如 果 函 数 调用 print() 中 的 字符 串 很 长 ， 


可 以 在 合适 的 位 置 分 行 。 只 需要 在 每 行 末 尾 都 加 上 引号 ， 同 时 对 于 
除 第 一 行 外 的 其 他 各 行 ， 都 在 行 首 加 上 引号 并 缩 进 。 这 样 ，Python 
将 自动 合并 圆 括号 内 的 所 有 字符 串 。 为 打印 配料 ， 编 写 一 个 for 循 
环 ( 见 人 @) 。 为 访问 配料 列表 ， 使 用 键 'toppings' ， 这 样 Python 
将 4 从 字典 中 提取 配料 列表 。 


下 面 的 输出 概述 了 要 制作 的 比 椭 : 


You ordered a thick-crust pizza with the following toppings: 


mushrooms 
extra cheese 


每 当 需 要 在 字典 中 将 一 个 键 关 联 到 多 个 值 时 ， 都 可 以 在 字典 中 航 套 
一 个 列表 。 在 本 章 前 面 有 关 喜 欢 的 编程 语言 的 示例 中 ， 如 果 将 每 个 
人 的 回答 都 存储 在 一 个 列表 中 ， 被 调查 者 就 可 选择 多 种 喜欢 的 语 
言 。 在 这 种 情况 下 ， 当 我 们 遇 历 字典 时 ， 与 每 个 被 调查 者 相关 联 的 
都 是 一 个 语言 列表 ， 而 不 是 一 种 语言 ， 因 此 ， 在 遍历 该 字典 的 for 
1 需要 再 使 用 一 个 for 循环 来 所 历 与 被 调查 者 相关 联 的 
| 省; 言 询 


favorite_languages.py 


@ favorite languages = { 
'jen': ['python', 'ruby'], 
'sarah': ['c'], 


"edward ' : [ ruby' ， go" ]， 
"phil': ['python', 'haskell'], 
} 


@ for name, languages in favorite languages.items(): 
print(f"\n{name.title()}'s favorite languages are:") 
© for language in languages: 
print(f"\t{language.title()}") 


如 你 所 见 ， 现 在 与 每 个 名 字 相 关联 的 值 都 是 一 个 列表 ( 见 @) 。 请 
注意 ， 有 些 人 喜欢 的 语言 只 有 一 种 ， 而 有 些 人 有 多 种 。 遍 历 字 典 时 
( 见 @) ， 使 用 变量 languages 来 依次 存储 对 字典 中 每 个 值 的 引 
用 ， 因 为 我 们 知道 这 些 值 都 是 列表 。 在 遍历 字典 的 主 循环 中 ， 使 用 
了 另 一 个 for 循环 ( 见 @) 来 遍历 每 个 人 喜欢 的 语言 列表 。 现 在 ， 
每 个 人 想 列 出 多 少 种 喜欢 的 语言 都 可 以 : 


Jen's favorite languages are: 
Python 
Ruby 


Sarah's favorite languages are: 
C 


Edward's favorite languages are: 
Ruby 
GO 


Phil's favorite languages are: 
Python 
Haskell 


为 进一步 改进 这 个 程序 ， 可 在 遍历 字典 的 for 循环 开头 添加 一 条 if 
语句 ， 通 过 查看 len(languages) 的 值 来 确定 当前 的 被 调查 者 喜欢 
的 语言 是 否 有 多 种 。 如 果 他 喜欢 的 语言 有 多 种 ， 就 像 以 前 一 样 显示 
输出 ; 如果 只 有 一 种 ， 就 相应 修改 输出 的 措 秤 ， 如 显示 Sarah's 


favorite language is 人 C 。 


注意 ”列表 和 字典 的 众 套 层级 不 应 太 多 。 如 末 钢 套 层 级 比 前 
面 的 示例 多 得 多 ， 很 可 能 有 更 简单 的 解决 方案 。 


6.4.3 ”在 字典 中 存储 字典 


可 在 字典 中 构 套 字典 ， 但 这 样 做 时 ， 代 码 可 能 很 快 复杂 起 来 。 例 
如 ， 如 果 有 多 个 网 站 用 户 ， 每 个 都 有 独特 的 用 户 名 ， 可 在 字典 中 将 
用 户 名 作为 键 ， 然 后 将 每 位 用 户 的 信息 存储 在 一 个 字典 中 ， 并 将 该 
字典 作为 与 用 户 名 相关 联 的 值 。 在 下 面 的 程序 中 ， 存 储 了 每 位 用 户 
的 三 项 信息 : 名 、 姓 和 居住 地 。 ee 局 历 所 有 的 
用 户 名 ， 并 访问 与 每 个 用 户 名 相关 联 的 信息 


many_users.py 


users = { 
"aeinstein': { 
'first': 'albert', 
'last': 'einstein', 
"location': 'princeton', 


2 


'mcurie': { 
'first': 'marie', 
"1ast': 'curie', 
"location': "paris '， 


}, 
} 


@ for username, user info in users.items() : 
print(f"\nUsername: {username}") 
full name = f"{user info['first']} {user info['last"']}" 
location = user info['location'] 


print(f"\tFull name: {full name.title()}") 
print(f"\tLocation: {location.title()}") 


首先 定义 一 个 名 为 users 的 学 上 典 ， 其 中 包含 两 个 键 : 用 户 

名 ， aeinstein' 和 'mcurie' 。 与 每 个 键盘 相关 联 的 值 都 是 一 个 字 
典 ， 其 中 包含 用 户 的 名 、 姓 和 居住 地 。 在 @@ 处 ， 遍 历 字 典 users ， 

让 Python 依次 将 每 个 键 赋 给 变量 username ， 并 依次 将 与 当前 键 相 

ee 。 在 循环 内 部 的 全 处 ， 将 用 户 名 打 
出 来 。 


在 个 处 ， 开 始 访问 内 部 的 字典 。 变 量 user_info 包含 用 户 信息 字 
典 ， 而 该 字典 包含 三 个 键 : 'first' 、'last' 和 'location' 。 
对 于 每 位 用 户 ， 都 使 用 这 些 键 来 生成 整洁 的 姓名 和 居住 地 ， 然 后 打 
印 有 关 用 户 的 简要 信息 ( 见 @) : 


Username: aeinstein 
Full name: Albert Einstein 
Location: Princeton 


Username: mcurie 
Full name: Marie Curie 
Location: Paris 


请 注意 ， 表 示 每 位 用 户 的 字典 都 共有 相同 的 结构 。 虽 然 Python 并 没 
有 这 样 的 要 求 ， 但 这 使 得 租 套 的 字典 处 理 起 来 更 容易 。 倘 名 表示 每 
位 用 户 的 字典 都 包含 不 同 的 键 ，for 循环 内 部 的 代码 将 更 复杂 。 


动手 试 一 试 
练习 6-7: 人 们 ”在 为 完成 练习 6-1 而 编写 的 程序 中 ， 再 创建 两 
个 表示 人 的 字典 ， 然 后 将 这 三 个 字典 都 存储 在 一 个 名 


为 people 的 列表 中 。 通 历 这 个 列表 ， 将 其 中 每 个 人 的 所 有 信 
息 都 打印 出 来 。 


练习 6-8: 宠物 创建 多 个 表示 宠物 的 字典 ， 每 个 字典 都 包含 
宠物 的 类 型 及 其 主人 的 名 字 。 将 这 些 字 典 存储 在 一 个 名 为 pets 
再 志 历 该 列表 ， 并 将 有 关 每 个 宠物 的 所 有 信息 都 打 
出 来 。 


练习 6-9: 喜欢 的 地 方 ” 创建 一 个 名 为 favorite_places 的 
字典 。 在 这 个 字典 中 ， 将 三 个 人 的 名 字 用 作 键 ， 并 存储 每 个 人 
喜欢 的 1 一 3 个 地 方 。 为 了 让 这 个 练习 更 有 趣 些 ， 可 以 让 一 些 朋 
友 说 出 他 们 喜欢 的 几 个 地 方 。 遍 历 这 个 字典 ， 并 将 其 中 每 个 人 
的 名 字 及 其 喜欢 的 地 方 打 印 出 来 。 


练习 6-10: 喜欢 的 数 2 ”修改 为 完成 练习 6-2 而 编写 的 程序 ， 让 
每 个 人 都 可 以 有 多 个 喜欢 的 数 ， 然 后 将 每 个 人 的 名 字 及 其 喜欢 


的 数 打印 出 来 。 


练习 6-11: 城市 ”创建 一 个 名 为 cities 的 字典 ， 将 三 个 城市 
名 用 作 键 。 对 于 每 座 城 市 ， 都 创建 一 个 字典 ， 并 在 其 中 包含 该 
城市 所 属 的 国家 、 人 口 约 数 以 及 一 个 有 关 该 城市 的 事实 。 在 表 
示 每 座 城市 的 字典 中 ， 应 包含 country 、population 和 fact 
等 键 。 将 每 座 城市 的 名 字 以 及 有 关 信 息 都 打印 出 来 。 


练习 6-12: 扩展 ”本章 的 示例 足够 复杂 ， 能 以 很 多 方式 进行 扩 
展 。 请 对 本 章 的 一 个 示例 进行 扩展 : 添加 键 和 值 、 调 整 程 序 要 
解决 的 问题 或 改进 输出 的 格式 。 


6.5 小结 


在 本 章 中 ， 你 学 习 3 了: 如何 定义 字典 ， 以 及 如 何 使 用 存储 在 字典 中 
的 信息 ; 如何 访问 和 修改 字典 中 的 元 素 ， 以 及 如 何 遍 历 字 典 中 的 所 
有 信息 ;如何 遇 历 字典 中 所 有 的 键 值 对 、 所 有 的 键 和 所 有 的 值 ， 如 
何在 列表 中 仍 套 字典 、 在 字典 中 明 套 列表 以 及 在 字典 中 藤 套 字典 。 


在 下 一 章 中 ， 你 将 学 习 while 循环 以 及 如 何 从 用 户 那里 获取 输入 。 
这 是 激动 人 心 的 一 革 ， 让 你 知道 如 何 将 程序 变 成 交互 性 的 ， 能 够 对 
用 户 输 入 做 出 啊 应 。 


用 户 输 入 和 while 循环 


大 多 数 程序 则 在 解决 最 终 用 户 的 问题 ， 为 此 通常 
需要 从 用 户 那 里 获取 一 些 信息 。 例 如 ， 假 设 有 人 要 判断 自己 是 
否 到 了 投票 年 龄 。 要 编写 回答 这 个 问题 的 程序 ， 就 需要 知道 用 
户 的 年 龄 ， 才 能 给 出 答案 。 因 此 ， 这 种 程序 需要 让 用 户 输入 
年 龄 ， 再 将 其 与 投票 年 龄 进行 比较 ， 以 判断 用 户 是 否 到 了 投票 
年 龄 ， 从 而 给 出 结果 。 


在 本 章 中 ， 你 将 学 习 如 何 接受 用 户 输入 ， 以 便 程 序 进 行 处 理 。 
程序 需要 一 个 名 字 时 ， 你 需要 提示 用 户 输 入 该 名 字 ; 程序 需要 
一 个 名 单 时 ， 你 需要 提示 用 户 输入 一 系列 名 字 。 为 此 ， 你 将 使 
用 函数 ijnput()。 


你 还 将 学 习 如 何 让 程序 不 断 地 运行 ， 以 便 用 户 根 据 需 要 输入 信 
上 忠 ， 并 在 程序 中 使 用 这 些 信息 。 为 此 ， 你 将 使 用 while 循环 让 
程序 不 断 运 行 ， 直 到 指定 的 条 件 不 满足 为 止 。 


通过 获取 用 户 输 入 并 学 会 控制 程序 的 运行 时 间 ， 你 就 能 编写 出 
交互 式 程序 。 


7.1 函数 input() 的 工作 原理 


函数 input() 让 程序 和 暂 俘 运行 ， 等 竺 用户 输 入 一 些 文本 。 获 取 用 户 
输入 后 ，Python 将 其 赋 给 一 个 变量 ， 以 方便 你 使 用 。 


例如 ， 下 面 的 程序 让 用 户 输入 一 些 文本 ， 再 将 这 些 文本 呈现 给 用 
户 : 


parrot.py 


message = input("Tell me something, and I will repeat it back to you: 
print(message) 


函数 input() 接受 一 个 参数 一 一 要 同 用 户 显 示 的 提示 (prompt) 
或 说 明 ， 让 用 户 知道 该 如 何 做 。 在 本 例 中 ，Python 运 行 第 一 行 代码 
时 ， 用 户 将 看 到 提示 Tell me something，and I will repeat 
it back to you: 。 程 序 等 等 用 户 输入 ， 并 在 用 户 按 回 车 键 后 继 
续 运 行 。 输 入 被 赋 给 变量 message ， 接 下 来 的 print(message) 将 
输入 呈现 给 用 户 : 


Tell me something, and I will repeat it back to you: Hello everyone! 
Hello everyone! 


注意 ”Sublime Text 等 众多 编辑 器 不 能 运行 提示 用 户 输入 的 程 
序 。 你 可 以 使 用 Sublime Text 来 编写 提示 用 户 输入 的 程序 ， 但 
必须 从 终端 运行 它们 。 详 情 请 参阅 1.5 节 。 


7.1.1 编写 清晰 的 程序 
每 当 使 用 函数 input() 时 ， 都 应 指定 清晰 易 懂 的 提示 ， 准 确 地 指出 


希望 用 户 提供 什么 样 的 信息 一 一 指出 用 户 应 该 输入 何 种 信息 的 任何 
提示 都 行 ， 如 下 所 示 : 


greeter.py 


name = input("Please enter your name: ") 
print(f"\nHello, {name}!") 


通过 在 提示 末尾 (这 里 是 冒号 后 向 ) 包含 一 个 空格 ， 可 将 提示 与 用 
户 输 入 分 开 ， 让 用 户 清楚 地 知道 其 输入 始 于 何 处 ， 如 下 所 示 : 


Please enter your name: Eric 
Hello, Eric! 


有 时 候 ， 提 示 可 能 超过 一 行 。 例 如 ， 你 可 能 需要 指出 获取 特定 输入 
的 原因 。 在 这 种 情况 下 ， 可 将 提示 赋 给 一 个 变量 ， 再 将 该 变量 传递 
给 函数 input() 。 这 样 ， 即 便 提示 超过 一 行 ，input() 语句 也 会 非 
第 清晰 。 


greeter.py 


prompt = "If you tell us who you are, we can personalize the messages 
prompt += "\nWhat is your first name? " 


name = input(prompt) 
print(f"\nHello, {name}!") 


本 例 演示 了 一 种 创建 多 行 字符 串 的 方式 。 第 一 行将 消息 的 前 半 部 分 
赋 给 变量 prompt 中 。 在 第 二 行 中 ， 运 算 符 += 在 前 面 赋 给 变量 
prompt 的 字符 串 末尾 附加 一 个 字符 串 。 


和 
[清晰 : 


If you tell us who you are, we can personalize the messages you see. 
What is your first name? Eric 


Hello, Eric! 


7.1.2 ”使 用 int() 来 获取 数值 输入 


使 用 函数 input() 时 ，Python 将 用 户 输 入 解读 为 字符 串 。 请 看 下 面 
让 用 户 输 入 年 龄 的 解释 器 会 话 : 


>>> age = input("How old are you? ") 
How old are you? 21 
>>> age 


2 


用 户 输入 的 是 数 21， 但 我 们 请 求 Python 提供 变量 age 的 值 时 ， 它 返 
回 的 是 " 21 用 尸 输入 数值 的 字符 捉 表 示 。 我 们 怎么 知道 
Python 将 输入 解读 成 了 字符 冲 呢 ? 因为 这 个 数 用 引号 括 起 了 。 如 采 
只 想 打印 输入 ， 这 一 点 问题 都 没有 ;但 如 条 试图 将 输入 作为 数 来 使 
用 ， 束 会 引 友 错误 : 


>>> age = input("How old are you? ") 
How old are you? 21 
@ >>> age >= 18 
Traceback (most recent call last): 
File "<stdin>", line 1, in <module> 
@ TypeError: unorderable types: str() >= int() 


试图 将 输入 用 于 数值 比较 时 〈 见 @)〉 ，Python 会 引发 错误 ， 因 为 它 
无 法 将 字符 串 和 整数 进行 比较 : 不 能 将 赋 给 age 的 字符 串 '21' 与 
数值 18 进行 比较 ( 见 @) 。 


为 解决 这 个 问题 ， 可 使 用 函数 int() ， 它 让 Python 将 输入 视 为 数 
值 。 函 数 int() 将 数 的 字符 串 表 示 转 换 为 数值 表示 ， 如 下 所 示 : 


>>> age = input("How old are you? ") 
How old are you? 21 

@ >>> age = int(age) 
>>> age >= 18 


True 


在 本 例 中 ， 用 户 根据 提示 输入 21 后 ，Python 将 这 个 数 解读 为 字符 
串 ， 但 随后 int() 将 这 个 字符 串 转 换 成 了 数值 表示 〈( 见 @) 。 这 样 
Python 就 能 运行 条 件 测 试 了 : 将 变量 age ( 它 现在 表示 的 是 数值 

21) 同 18 进行 比较 ， 看 它 是 否 大 于 或 等 于 18。 测 试 结果 为 True 。 


如 何在 实际 程序 中 使 用 函数 int() 呢 ? 请 看 下 面 的 程序 ， 它 判断 一 
个 人 是 否 满足 坐 过 山 车 的 号 高 要 求 : 


rollercoaster.py 


height 
height 


input("How tall are you, in inches? ") 
int(height) 


if height >= 48: 
print("\nYou're tall enough to ride!") 
else: 
print("\nYou'll be able to ride when you're a little older.") 


在 此 程序 中 ， 为 何 可 以 将 height 同 48 进行 比较 呢 ?” 因 为 在 比较 
前 ，height = int(height) 将 输入 转换 成 了 数值 表示 。 如 果 输 
入 的 数 大 于 或 等 于 48， 就 指出 用 户 满足 身高 条 件 : 


How tall are you, in inches? 71 


You're tall enough to ridel 


将 数值 输入 用 于 计算 和 比较 前 ， 务 必 将 其 转换 为 数值 表示 。 
7.1.3” 求 模 运 算 符 


处 理 数值 信息 时 ， 求 模 运算 符 (%) 是 个 很 有 用 的 工具 ， 它 将 两 个 
数 相 除 并 返回 余数 : 


求 模 运 算 符 不 会 指出 一 个 数 是 另 一 个 数 的 多 少 倍 ， 只 指出 余数 是 多 


少 。 


如 琳 一 个 数 可 被 为 一 个 数 整 除 ， 余 数 残 为 0， 因 此 求 模 运算 将 返回 
0。 可 利用 这 一 点 来 判断 一 个 数 是 奇效 还 是 偶数 : 


even_or_odd.py 


number 
number 


= input("Enter a number, and I'11 tell you if it's even or odd: 
= int(number) 
if number % 2 == 0@: 
print(f"\nThe number {number} is even.") 
else: 
print(f"\nThe number {number} is odd.") 


俩 数 都 能 被 2 整除 ， 因 此 如 果 对 一 个 数 和 2 执行 求 模 运 算 的 结果 为 
0， 即 number % 2 == 6 ， 那 么 这 个 数 束 是 偶数 ; 否则 惑 是 奇数 。 


Enter a number，and I'11 tell you if it's even or odd: 42 


The number 42 is even. 


动手 试 一 斌 


练习 7-1: 汽车 租赁 ”编写 一 个 程序 ， 询 问 用 户 要 租赁 什么 样 
的 汽车 ， 并 打印 一 条 消息 ， 下 面 是 一 个 例子 。 


Let me see if I can find you a Subaru. 

练习 7-2: 餐馆 订 位 ”编写 一 个 程序 ， 询 问 用 户 有 多 少 人 用 
餐 。 如 果 超 过 8 位 ， 就 打印 一 条 消 恩 ， 指 出 没有 空 果 ; 否则 指 
出 有 空 果 。 


练习 7-3，10 的 整数 倍 ”让 用 户 输 入 一 个 数 ， 并 指出 该 数 是 否 
是 10 的 整数 信 。 


7.2 While 循环 简介 


for 循环 用 于 针对 集合 中 的 每 个 元 系 都 执行 一 个 代码 块 ， 而 while 
循环 则 不 断 运 行 ， 直 到 指定 的 条 件 不 满足 为 止 。 


7.2.1 使 用 while 循环 
可 使 用 while 循环 来 数 数 。 人 例如， 下面 的 while 循环 从 1 数 到 5: 


counting.py 


current number = 1 
while current number <= 5: 
print(current number) 


current number += 1 


在 第 一 行 ， 将 1 赋 给 变量 current_number ， 从 而 指定 从 1 开始 
数 。 将 接 下 来 的 while 循环 设置 成 : 只 要 current_number 小 于 或 
等 于 5， 就 接着 运行 这 个 循环 。 循 环 中 的 代码 打印 current_number 
的 值 ， 再 使 用 代码 current_number += 1 〈 代 

码 current_number = current_number + 1 的 简写 ) 将 其 值 加 
1。 


只 要 满足 条 件 current_number “= 5 ，Python 束 接着 运行 这 个 循 
环 。 因 为 1 小 于 5， 所 以 Python 打印 1 并 将 current_number 加 1， 使 
其 为 2; 因为 2 小 于 5， 所 以 Python 打印 2 并 将 current_number 加 

1， 使 其 为 3;， 依 此 类 推 。 一 旦 current_number 大 于 5， 循 环 就 将 
停止 ， 整 个 程序 也 将 结束 : 


UPUWUDP 


你 每 天 使 用 的 程序 很 可 能 就 包含 while 循环 。 例 如 ， 游 戏 使 

用 while 循环 ， 确 保 在 玩家 想 玩 时 不 断 运行 ， 并 在 玩家 想 退 出 时 停 
止 运行 。 如 果 程 序 在 用 户 没 有 让 它 停 止 时 停止 运行 ， 或 者 在 用 户 要 
退出 时 还 继续 运行 ， 那 就 太 没有 意思 了 。 因 此 ，while 循环 很 有 
用 。 


7.2.2 ”让 用 户 选 择 何 时 退出 
可 以 使 用 while 循环 让 程序 在 用 户 愿 意 时 不 断 运行 ， 如 下 面 的 程序 
辐 


parrot py 所 示 。 我 们 在 其 中 定义 了 一 个 退出 值 ， 只 要 用 户 输 入 的 不 
征 这 个 值 ， 程 序 就 将 接着 运行 : 


parrot.py 


@ prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter ‘quit' to end the program. " 

@ message = "" 

e@ While message != 'qguit'": 


message = input(prompt) 
print(message) 


@ 处 定义 了 一 条 提示 消息 ， 告 诉 用 户 有 两 个 选择 要么 输入 一 条 消 
息 ， 要 么 输入 退出 值 (这 里 为 'quit' ) 。 接 下 来 ， 创 建 变量 
message ( 见 @) ， 用 于 记录 用 户 输入 的 值 。 我 们 将 变量 message 
的 初始 值 设 置 为 空 字 符 串 "" ， 让 Python 首次 执行 while 代码 行 时 有 
可 供 检查 的 东西 。Python 首 次 执行 while 语句 时 ， 需 要 将 message 
的 值 与 'quit ' 进行 比较 ， 但 此 时 用 户 还 没有 输入 。 如 果 没 有 可 供 
比较 的 东西 ，Python 将 无 法 继续 运行 程序 。 为 解决 这 个 问题 ， 必 须 
给 变量 message 指定 初始 值 。 虽 然 这 个 初始 值 只 是 一 个 空 字符 串 ， 
但 符合 要 求 ， 能 够 让 Python 执行 while 循环 所 需 的 比较 。 只 要 
message 的 值 不 是 'quit' ， 这 个 循环 ( 见 @) 就 会 不 断 运行 。 


首次 遇 到 这 个 循环 时 ，message 是 一 个 空 字 符 串 ， 因 此 Python 进入 
该 循环 。 执 行 到 代码 行 message = input(prompt) 时 ，Python 显 
示 提 示 消 息 ， 并 等 竺 用户 输 入 。 不 管用 户 输 入 是 什么 ， 都 将 赋 给 变 
量 message 并 打印 出 来 。 接 下 来 ，Python 重 新 检查 while 语句 中 的 
条 件 。 只 要 用 户 输入 的 不 是 单词 'quit' ，Python 束 会 再 次 显示 提 


示 消 轧 并 等 得 用 户 输入 。 等 到 用 户 终 于 输入 'quit" 后 ，Python 停 
止 执 行 while 循环 ， 整 个 程序 也 到 此 结 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello everyone! 
Hello everyone! 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello again. 


Hello again. 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. quit 
quit 


这 个 程序 很 好 ， 唯 一 美中不足 的 是 ， 它 将 单词 'quit" 也 作为 一 条 
消息 打印 了 出 来 。 为 修复 这 种 问题 ， 只 雷 使 用 一 个 简单 的 if 测 
试 : 


prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter ‘quit' to end the program. " 


message = "" 
while message != 'quit ' : 
message = input(prompt) 


if message != 'quit ' : 
print(message) 


0 ， 程 序 在 显示 消 姑 前 将 做 简单 的 检查 ， 仪 在 消 乱 不 是 退出 值 时 
打印 它 : 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello everyone! 
Hello everyone! 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. Hello again. 
Hello again. 


Tell me something, and I will repeat it back to you: 
Enter 'quit' to end the program. quit 


7.2.3 ”使 用 标志 
在 前 一 个 示例 中 ， 我 们 让 程序 在 满足 指定 条 件 时 执行 特定 的 任务 。 


但 在 更 复杂 的 程序 中 ， 很 多 不 同 的 事件 会 导致 程序 停止 运行 。 在 这 
种 情况 下 ， 该 怎么 办 呢 ? 


例如 ， 有 多 种 事件 可 能 导致 游戏 结束 ， 如 玩家 失去 所 有 飞船 、 时 间 
已 用 完 ， 或 者 要 保护 的 城市 被 全 部 摧毁 。 导 致 程序 结束 的 事件 有 很 
0 
难 。 


在 要 求 很 多 条 件 都 满足 才 继 续 运 行 的 程序 中 ， 可 定义 一 个 变量 ， 用 
于 判断 整个 程序 是 否 处 于 活动 状态 。 这 个 变量 称 为 标志 (flag) ， 
充当 程序 的 交通 信号 灯 。 可 以 让 程序 在 标志 为 True 时 继续 运行 ， 
并 在 任何 事件 导致 标志 的 值 为 False 时 让 程序 停止 运行 。 这 样 ， 
在 while 语句 中 就 只 需 检 查 一 个 条 件 : 标志 的 当前 值 是 否 为 True 
。 然 后 将 所 有 其 他 测试 (是 否 友 生 了 应 将 标志 设置 为 False 的 事 
件 ) 都 放 在 其 他 地 方 ， 从 而 让 程序 更 整洁 。 


下 面 在 前 一 节 的 程序 parrot.py 中 添加 一 个 标志 。 将 其 命名 为 active 
(你 可 给 它 指定 任何 名 称 〉， 用 于 判断 程序 是 否 应 继续 运行 : 


prompt = "\nTell me something, and I will repeat it back to you:" 
prompt += "\nEnter ‘quit' to end the program. " 


@ active = True 
@ while active: 
message = input(prompt) 


if message == 'quit ' : 
active = False 
else: 
print(message) 


将 变量 active 设置 为 True ( 见 @) ， 让 程序 最 初 处 于 活动 状态 。 
这 样 做 简化 了 while 语句 ， 因 为 不 需要 在 其 中 做 任何 比较 一 一 相关 
的 逻辑 由 程序 的 其 他 部 分 处 理 。 只 要 变量 active 为 True ， 循 环 就 
将 继续 运行 ( 见 @) 。 


在 while 循环 中 ， 在 用 户 输 入 后 使 用 一 条 if 语句 来 检查 变量 
message 的 值 。 如 果 用 户 输入 的 是 "quit' 【( 见 @) ， 就 将 变量 
active 设置 为 False 。 这 将 导致 while 循环 不 再 继续 执行 。 如 果 
人 〈( 见 四 ) ， 就 将 输入 作为 一 条 消息 打印 出 


这 个 程序 的 输出 与 前 一 个 示例 相同 。 前 一 个 示例 将 条 件 测试 直接 放 
在 了 while 语句 中 ， 而 这 个 程序 则 使 用 一 个 标志 来 指出 程序 是 否 处 
于 活动 状态 。 这 样 ， 如 果 要 添加 测试 (如 elif 语句 ) 以 检查 是 否 
发 生 了 其 他 导致 active 变 为 False 的 事件 ， 就 会 很 容易 。 在 复杂 
的 程序 (如 很 多 事件 会 导致 程序 停止 运行 的 游戏 ) 中 ， 标 志 很 有 

用 : 在 任意 一 个 事件 导致 活动 标志 变 成 False 时 ， 主 游戏 循环 将 退 
出 ， 此 时 可 显示 一 条 游戏 结束 消息 ， 并 让 用 户 选 择 是 否 要 重新 玩 。 


7.2.4 使 用 break 退出 循环 


要 立即 退出 while 循环 ， 不 再 运行 循环 中 余下 的 代码 ， 也 不 管 条 件 
测试 的 结果 如 何 ， 可 使 用 break 语句 。break 语句 用 于 控制 程序 流 
程 ， 可 用 来 控制 哪些 代码 行将 执行 、 哪 些 代 码 行 不 执行 ， 从 而 让 程 
序 按 你 的 要 求 执行 你 要 执行 的 代码 。 


例如 ， 来 看 一 个 让 用 户 指 出 他 到 过 哪些 地 方 的 程序 。 在 这 个 程序 
中 ， 可 在 用 户 输入 'quit"' 后 使 用 break 语句 立即 退出 while 循 
环 : 


cities.py 


prompt = "\nPlease enter the name of a city you have visited:" 
prompt += "\n(Enter 'quit' when you are finished.) " 


@ while True: 
city = input(prompt) 


if city == 'quit': 


break 
else: 
print(f"I'd love to go to {city.title()}!") 


以 while True ( 见 @) 打头 的 循环 将 不 断 运 行 ， 直 到 遇 到 break 
语句 。 这 个 程序 中 的 循环 不 断 让 用 户 输入 他 到 过 的 城市 的 名 字 ， 直 
到 用 户 输入 "quit ' 为 止 。 用 户 输入 'quit ' 后 ， 将 执行 break 语 

句 ， 导 致 Python 退出 循环 : 


Please enter the name of a city you have visited: 
(Enter 'quit' when you are finished.) New York 
I'd love to go to New York! 


Please enter the name of a city you have visited: 
(Enter ‘quit' when you are finished.) San Francisco 
I'd love to go to San Francisco! 


Please enter the name of a city you have visited: 
(Enter ‘quit' when you are finished.) quit 


注意 “在 任何 Python 循环 中 都 可 使 用 break 语句 。 例 如 ， 可 使 
用 break 语句 来 退出 遍历 列表 或 字典 的 for 循环 。 


7.2.5 ”在 循环 中 使 用 continue 


要 返回 循环 开头 ， 并 根据 条 件 测 试 结果 决定 是 否 继续 执行 循环 ， 可 
使 用 continue 语句 ， 它 不 像 break 语句 那样 不 再 执行 余下 的 代码 
人 例如 ， 来 看 一 个 从 1 数 到 10 但 只 打印 其 中 奇数 的 
循环 : 


counting.py 


current number = 6 
while current number < 108: 
@ current number += 1 
if current number % 2 == 
continue 


print(current number) 


首先 将 current_number 设置 为 0， 由 于 它 小 于 10，Python 进 

入 while 循环 。 进 入 循环 后 ， 以 步 长 1 的 方式 和 福 上 数 〈 见 @@) ， 因 
此 current_number 为 1。 接 下 来 ，if 语句 检查 current_number 
与 2 的 求 模 运 算 结 果 。 如 果 结 果 为 0 (意味 着 current_number 可 被 
2 整除 ) ， 束 执行 continue 语句 ， 让 Python 忽 略 余下 的 代码 ， 并 返 
回 循环 的 开头 。 如 采 当 前 的 数 不 能 被 2 整除 ， 就 执行 循环 中 余下 的 
代码 ， 将 这 个 数 打印 出 来 : 


OQ]UVUWP 


7.2.6 ”避免 无 限 循环 


每 个 while 循环 都 必须 有 停止 运行 的 途径 ， 这 样 才 不 会 没完 没 了 地 
执行 下 去 。 例 如 ， 下 面 的 循环 从 1 数 到 5: 


counting.py 


义演 :- 江 
while x <= 5: 
print(x) 


X += 1 


但 如 果 像 下 面 这 样 不 小 心 遗漏 了 代码 行 x += 1 ， 这 个 循环 将 没完 
没 了 地 运行 : 


# 这 个 循环 将 没完 没 了 地 运行 ! 
X = 1 
while x <= 5: 

print(x) 


| 


在 这 里 ，x 的 初始 值 为 1 ， 但 根本 不 会 变 。 因 此 条 件 测试 x <= 5 始 
终 为 True ， 导 致 while 循环 没完 没 了 地 打印 1 ， 如 下 所 示 : 


每 个 程序 员 都 会 倘 尔 因 不 小 心 而 编写 出 无 限 循 环 ， 在 循环 的 退出 条 
件 比 较 微妙 时 尤其 如 此 。 如 有 果 程 序 陷 入 无 限 循环 ， 可 按 Ctrl + C， 


也 可 关闭 显示 程序 输出 的 终端 窗口 。 


要 避免 编写 无 限 循环 ， 务 必 对 每 个 while 循环 进行 测试 ， 确 保 其 按 
预期 那样 结束 。 如 果 你 希望 程序 在 用 户 输入 特定 值 时 结束 ， 可 运行 
程序 并 输入 这 样 的 值 。 如 果 在 这 种 情况 下 程序 没有 结束 ， 请 检查 程 
序 处 理 这 个 值 的 方式 ， 确 认 程 序 至 少 有 一 个 这 样 的 地 方 能 让 循环 条 
件 为 False ， 或 者 让 break 语句 得 以 执行 。 


注意 ”Sublime Text 等 一 些 编辑 堪 内 人 其 了 输出 窗口 ， 这 可 能 导 
致 难以 结束 无 限 循环 ， 不 得 不 通过 关闭 编辑 吉 来 结束 。 在 这 种 
情况 下 ， 可 在 输出 窗口 中 单 击 鼠 标 ， 再 按 Ctrl + C， 这 样 应 该 
能 够 结束 无 限 循 环 。 


动手 试 一 斌 


练习 7-4: 比 了 柑 配料 ”编写 一 个 循环 ， 提 示 用 户 输入 一 系列 比 
萨 配料 ， 并 在 用 户 输入 'quit ' 时 结束 循环 。 每 当 用 户 输入 一 
We 都 打印 一 条 消 妃 ， 指 出 我 们 会 在 比 革 中 添加 这 种 配 


练习 7-5: 电影 票 ”有 家 电影 院 根据 观众 的 年 龄 收取 不 同 的 票 


价 : 不 到 3 岁 的 观众 免费 ，3 一 12 岁 的 观众 收费 10 美 元 ;超过 12 
岁 的 观众 收费 15 美 元 。 请 编写 一 个 循环 ， 在 其 中 询问 用 户 的 年 
龄 ， 并 指出 其 票 价 。 


练习 7-6: 三 种 出 路 ”以 不 同 的 方式 完成 练习 7-4 或 练习 7-5， 
在 程序 中 采取 如 下 做 法 。 


。 在 while 循环 中 使 用 条 件 测试 来 结束 循环 。 
。 使 用 变量 active 来 控制 循环 结束 的 时 机 。 
。 使 用 break 语句 在 用 户 输入 "quit ' 时 退出 循环 。 


练习 7-7: 无 限 循环 ”编写 一 个 没 宛 没 了 的 循环 ， 并 运行 它 
《要 结束 该 循环 ， 可 按 Ctrl + C， 也 可 关闭 显示 输出 的 窗 
辐 洒 总 


7.3 使 用 while 循环 处 理 列 表 和 字典 


到 目前 为 止 ， 我们 每 次 都 只 处 理 了 一 项 用 户 信 息 : 获取 用 户 的 输 
入 ， 再 将 输入 打印 出 来 或 做 出 应 答 ; 循环 再 次 运行 时 ， 获 悉 男 一 个 
输入 值 并 做 出 啊 应 。 然 而 ， 要 记录 大 量 的 用 户 和 信息 ， 需 要 

在 while 循环 中 使 用 列表 和 字典 。 


for 循环 是 一 种 过 有 历 列 表 的 有 效 方式 ， 但 不 应 在 for 循环 中 修改 列 

， 人 否则 将 导致 Python 难以 跟踪 其 中 的 元 系 。 要 在 所 历 列表 的 同时 
对 其 进行 修改 ， 可 使 用 while 循环 。 通 过 将 while 循环 同 列表 和 字 
典 结 合 起 来 使 用 ， 可 收集 、 存 储 并 组 织 大 量 输入 ， 供 以 后 查看 和 显 
NE 


7.3.1 ”在 列表 之 则 移动 元 素 


假设 有 一 个 列表 包含 新 注册 但 还 未 验证 的 网 站 用 户 。 验 证 这 些 用 户 
后 ， 如 何 将 他 们 移 到 男 一 个 已 验证 用 户 列表 中 呢 ? 一 种 办 法 是 使 用 
一 个 while 循环 ， 在 验证 用 户 的 同时 将 其 从 未 验证 用 户 列表 中 提取 
再 将 其 加 入 男 一 个 已 验证 用 户 列 表 中 。 代 码 可 能 类 似 于 下 面 
这 样 : 


confirmed_users.py 


# 首先 ， 创 建 一 个 待 验证 用 户 列 表 


# 和 一 个 用 于 存储 已 验证 用 户 的 空 列表 。 
@ unconfirmed users = ['alice', 'brian', 'candace'| 
confirmed users = [] 


# 验证 每 个 用 户 ， 直 到 没有 未 验证 用 户 为 止 。 

# 将 每 个 经 过 验证 的 用 户 都 移 到 已 验证 用 户 列表 中 。 
@ while unconfirmed users: 
© current user = unconfirmed users.pop() 


print(f"Verifying user: {current user.title()}") 
@ confirmed users.append(current_ user) 


# 显示 所 有 已 验证 的 用 户 。 
print("\nThe following users have been confirmed:") 
for confirmed user in confirmed _ users : 


print(confirmed user.title()) 


首先 创建 一 个 未 验证 用 户 列表 ( 见 @)， ， 其 中 包含 用 户 Alice、 
Brian 和 Candace， 还 创建 了 一 个 空 列表 ， 用 于 存储 已 验证 的 用 户 。 
四 处 的 while 循环 将 不 断 运 行 ， 直 到 列表 unconfirmed_users 变 
成 空 的 。 在 此 循环 中 ， 合 处 的 方法 pop() 以 每 次 一 个 的 方式 从 列 
表 unconfirmed_users 末尾 删除 未 验证 的 用 户 。 由 于 Candace 位 于 
列表 unconfirmed_users 末尾 ， 其 名 字 将 首先 被 删除 、 赋 给 变量 
current_user 并 加 入 列表 confirmed_users 中 ( 见 @@) 。 接 下 
来 是 Brian， 然 后 是 Alice。 


为 模拟 用 户 验 证 过 程 ， 我 们 打印 一 条 验证 消 恩 并 将 用 户 加 入 已 验证 


用 尸 列表 中 。 未 验证 用 户 列 表 越 来 越 短 ， 而 已 验证 用 户 列 表 越 来 越 
长 。 未 验证 用 户 列 表 为 空 后 结束 循环 ， 再 打印 已 验证 用 户 列表 : 


Verifying user: Candace 
Verifying user: Brian 
Verifying user: Alice 


The following users have been confirmed : 
Candace 

Brian 

Alice 


7.3.2 ”删除 为 特定 值 的 所 有 列表 元 素 


在 第 3 章 中 ， 我 们 使 用 函数 remove( ) 来 删除 列表 中 的 特定 值 。 这 之 
所 以 可 行 ， 是 因为 要 删除 的 值 只 在 列表 中 出 现 一 次 。 如 果 要 删除 列 
表 中 所 有 为 特定 值 的 元 素 ， 该 怎么 办 呢 ? 


假设 你 有 一 个 宠物 列表 ， 其 中 包含 多 个 值 为 "cat ' 的 元 素 。 要 删除 
所 有 这 些 元 素 ， 可 不 断 运行 一 个 while 循环 ， 直 到 列表 中 不 再 包含 
值 'cat' ， 如 下 所 示 : 


pets.py 


pets = ['dog', 'cat', 'dog', 'goldfish', 'cat', "rabbit'， "cat ] 
print(pets) 


while 'cat' in pets : 
pets.remove('cat') 


print(pets) 


首先 创建 一 个 列表 ， 其 中 包含 多 个 值 为 "cat ' 的 元 素 。 打 印 这 个 列 
表 后 ，Python 进 入 while 循环 ， 因 为 它 发 现 ' cat ' 在 列表 中 人 至少 出 
现 了 一 次 。 进 入 该 循环 后 ，Python 删 除 第 一 个 'cat' 并 返回 

到 while 代码 行 ， 然 后 发 现 ' cat ' 还 包含 在 列表 中 ， 因 此 再 次 进入 
循环 。 它 不 断 删 除 ' cat' ， 直 到 这 个 值 不 再 包含 在 列表 中 ， 然 后 退 
出 循环 并 再 次 打印 列表 : 


['dog', 'cat', 'dog', 'goldfish', 'cat', 'rabbit', 'cat'] 
['dog', 'dog', 'goldfish', 'rabbit'] 


7.3.3 ”使 用 用 户 输入 来 填充 字典 


可 使 用 while 循环 提示 用 户 输入 任意 多 的 信息 。 下 面 创 建 一 个 调查 
程序 ， 其 中 的 循环 每 次 执行 时 都 提示 输入 被 调查 者 的 名 字 和 回答 。 
人 以 便 将 回答 同 被 调查 者 关联 
来 : 


mountain_poll.py 


responses = {} 


# 设置 一 个 标志 ， 指 出 调查 是 否 继 续 。 
polling active = True 


while polling active: 
# 提示 输入 被 调查 者 的 名 字 和 回答 。 
@ name = input("\nWhat is your name? ") 
response = input("Which mountain would you like to climb someday 


# 将 回答 存储 在 字典 中 。 


@ responses[name] = response 


# 看 看 是 否 还 有 人 要 参与 调查 。 
@ repeat = input("Would you like to let another person respond? (y 
if repeat == 'no': 
polling active = False 


# 调查 结束 ， 显 示 结 果 。 
print("\n--- Poll Results ---") 
@ for name, response in responses.items(): 
print(f"{name} would like to climb {response}.") 


这 个 程序 首先 定义 了 一 个 空 字典 (responses ) ， 并 设置 了 一 个 标 
志 (polling_active ) 用 于 指出 调查 是 否 继续 。 只 要 
polling_active 为 True ，Python 就 运行 while 循环 中 的 代码 。 


在 这 个 循环 中 ， 提 示 用 户 输入 其 名 字 及 其 喜欢 扑 哪 座 山 ( 见 @) 。 

将 这 些 信息 存储 在 字典 responses 中 ( 见 @) ， 然 后 询问 用 户 是 否 
继续 调查 〈( 见 @) 。 如 果 用 户 输入 yes ， 程 序 将 再 次 进入 while 循 
环 ; 如 果 用 户 输入 no ， 标 志 polling_active 将 被 设置 为 False 

， 而 while 循环 将 就 此 结束 。 最 后 一 个 代码 块 〈 见 四 ) 显示 调查 结 
果 。 


J 并 输入 一 些 名 字 和 回答 ， 输 出 将 类 似 于 下 面 这 


What is your name? Eric 
Which mountain would you like to climb someday? Denali 
Would you like to let another person respond? (yes/ no) yes 


What is your name? Lynn 
Which mountain would you like to climb someday? Devil's Thumb 


Would you like to let another person respond? (yes/ no) no 


--- Poll Results --- 
Eric would like to climb Denali. 
Lynn would like to climb Devil's Thumb. 


动手 试 一 斌 


练习 7-8: 熟食 店 ”创建 一 个 名 为 sandwich_orders 的 列表 ， 
在 其 中 包含 各 种 三 明治 的 名 字 ， 再 创建 一 个 名 

为 finished_sandwiches 的 空 列表 。 遍 历 列 

表 sandwich_orders ， 对 于 其 中 的 每 种 三 明治 ， 都 打印 一 条 
消息 ， 如 I _ made your tuna sandwich ， 并 将 其 移 到 列 

表 finished_sandwiches 中 。 所 有 三 明治 都 制作 好 后 ， 打 印 
-条 消息 ， 将 这 些 三 明治 列 出 来 。 


练习 7-9: 五 香烟 票 牛肉 卖 完 了 使 用 为 完成 练习 7-8 而 创建 的 
列表 sandwich_orders ， 并 确保 'pastrami' 在 其 中 至 少 出 
现 了 三 次 。 在 程序 开头 附近 添加 这 样 的 代码 : 打印 一 条 消息 ， 
指出 熟食 店 的 五 香烟 一 牛 肉 (pastrami) 卖 完了 ; 再 使 用 一 

个 while 循环 将 列表 sandwich_orders 中 的 "pastrami' 都 
删除 。 确 认 最 终 的 列表 finished_sandwiches 未 包 

含 'pastrami' 。 


练习 7-10: 梦想 的 度假 胜地 ”编写 一 个 程序 ， 调 碍 用 户 梦 想 
的 度假 胜地 。 使 用 类 似 于 下 面 的 提示 ， 并 编写 一 个 打印 调查 结 
果 的 代码 块 。 


If you could visit one place in the world, where would you go? 


7.4 小结 


在 本 章 中 ， 你 学 习 了 : 如 何在 程序 中 使 用 input() 来 让 用 户 提 供 信 
恩 ; 如何 处 理 文本 和 数 的 输入 ， 以 及 如 何 使 用 while 循环 让 程序 按 
用 户 的 要 求 不 断 运行 ， 多 种 控制 while 循环 流程 的 方式 : 设置 活动 
标志 、 使 用 break 语句 以 及 使 用 continue 语句 ; 如 何 使 用 while 
循环 在 列表 之 间 移 动 元 素 ， 以 及 如 何 从 列表 中 删除 所 有 包含 特定 值 
的 元 素 ， 如 何 结合 使 用 while 循环 和 字典 。 


在 第 8 章 中 ， 你 将 学 习 函 数 。 函 数 让 你 能 够 将 程序 分 成 多 个 很 小 的 
部 分 ， 每 部 分 都 负责 完成 一 项 具体 任务 。 你 可 以 根据 需要 调用 同一 
个 函数 任意 次 ， 还 可 将 函数 存储 在 独立 的 文件 中 。 使 用 函数 可 让 你 
人 
星 序 


产 在 本 章 中 ， 你 将 学 习 编写 函数 。 函 数 是 带 名 字 的 
代码 亿 用 于 完成 共 体 的 工作 。 要 执行 函数 定义 的 特定 任务 ， 
可 调用 该 函数 。 需 要 在 程序 中 多 次 执行 同一 项 任务 时 ， 无 须 
反复 编写 完成 该 任务 的 代码 ， 0 
让 Python 运行 其 中 的 代码 即 可 。 你 将 发 现 ， 通 过 使 用 函数 ， 程 
序 编写 阅读、 测试 和 修复 起 来 都 更 加 容易 。 


你 还 将 学 习 同 函数 传递 信息 的 方式 ， 学习 如 何 编写 主要 任务 是 
显示 信息 的 函数 ， 以 及 骨 在 处 理 数 据 并 返回 一 个 或 一 组 值 的 函 
数 ， 最 后 ， 学 习 如 何 将 函数 存储 在 称 为 模 岂 的 独立 文件 中 ， 
让 主 程序 文件 的 组 织 更 为 有 序 。 


8.1 定义 函数 
下 面 是 一 个 打印 问候 语 的 简单 函数 ， 名 为 greet_user() : 
greeter.py 


@ def greet user(): 
@ "显示 简单 的 问候 语 。""" 
日 print("Hello!") 


@ greet user() 


本 例 演 示 了 最 简单 的 函数 结构 。@@ 处 的 代码 行使 用 关键 字 def 来 告 
诉 Python， 你 要 定义 一 个 函数 。 这 是 函数 定义 ， 向 Python 指 出 了 函 
数 名 ， 还 可 能 在 圆 括号 内 指出 函数 为 完成 任务 需要 什么 样 的 信息 。 
在 这 里 ， 函 数 名 为 greet_user() ， 它 不 需要 任何 信息 就 能 完成 工 
作 ， 因 此 括号 是 空 的 〈 即 便 如 此 ， 括 号 也 必 不 可 少 ) 。 最 后 ， 定 义 
以 冒号 结尾 。 


紧 跟 在 def greet_user(): 后 面 的 所 有 缩 进 行 构成 了 函数 体 。 四 
处 的 文本 是 称 为 文档 字符 串 〈docstring) 的 注释 ， 描 述 了 函数 是 做 
什么 的 。 文 档 字符 串 用 三 引号 括 起 ，Python 使 用 它们 来 生成 有 关 程 
序 中 函数 的 文档 。 


代码 行 print("Hello!") 〈 见 全 ) 是 函数 体内 的 唯一 一 行 代码 ， 
因此 greet_user() 只 做 一 项 工作 : 打印 Hellol 。 

要 使 用 这 个 函数 ， 可 调用 它 。 函 数 调 用 让 Python 执行 函数 的 代码 。 
要 调用 函数 ， 可 依次 指定 函数 名 以 及 用 圆 括号 括 起 的 必要 信息 ， 
如 个 处 所 示 。 由 于 这 个 函数 不 需要 任何 信息 ， 调 用 它 时 只 需 答 
入 greet_user() 即 可 。 和 预期 一 样 ， 它 打印 Hel1lol : 


8.1.1 问 函 数 传 递 信 息 


只 需 稍 作 修 改 ， 就 可 让 函数 greet_user() 不 仅 向 用 户 显示 Hellol 
， 还 将 用 户 的 名 字 作 为 抬头 。 为 此 ， 可 在 函数 定义 def 
greet_user() 的 括号 内 添加 username 。 通 过 在 这 里 添 

加 username ， 可 让 函数 接受 你 给 username 指定 的 任何 值 。 现 
在 ， 这 个 函数 要 求 你 调用 它 时 给 username 指定 一 个 值 。 调 

用 greet_user() 时 ， 可 将 一 个 名 字 传 递 给 它 ， 如 下 所 示 ; 

def greet user(username) 


"" "显示 简单 的 问候 语 。""" 
print(f"Hello, {username.title()}!") 


greet user('jesse') 


代码 greet_user('jesse') 调用 函数 greet_user() ， 并 回 它 提 
供 执行 函数 调用 print() 所 需 的 信息 。 这 个 函数 接受 你 传递 给 它 的 
名 字 ， 并 同 这 个 人 发 出 问候 : 


Hello, Jessel! 


同样 ，greet_user('sarah') 调用 函数 greet_user() 并 同 它 传 
递 'sarah' ， 从 而 打印 Hello，Sarah! 。 可 根据 需要 调用 函 
ee 任意 次 ， 调 用 时 无 论 传 入 什么 名 字 ， 都 将 生成 相 
立 的 输出 。 


8.1.2” 实 参 和 形 参 


前 面 定 义 函 数 greet_user() 时 ， 要 求 给 变量 username 指定 一 个 
值 。 调 用 这 个 函数 并 提供 这 种 信息 〈 人 名 ) 时 ， 它 将 打印 相应 的 问 
候 语 。 


在 函数 greet_user() 的 定义 中 ， 变 量 username 是 一 个 形 参 
(parameter) ， 即 函数 完成 工作 所 需 的 信息 。 在 代 
码 greet_user('jesse') 中 ， 值 'jesse' 是 一 个 实 参 


(argument) ， 即 调用 函数 时 传递 给 函数 的 信息 。 调 用 函数 时 ， 将 
要 让 函数 使 用 的 信息 放 在 圆 括号 内 。 在 greet_user( "jesse ') 

中 ， 将 实 参 "jesse ' 传递 给 了 函数 greet_user() ， 这 个 值 被 赋 给 
了 形 参 username 。 


注意 ”大 家 有 时 候 会 形 参 、 实 参 不 分 ， 因 此 如 果 你 看 到 有 人 


将 函数 定义 中 的 变量 称 为 实 参 或 将 函数 调用 中 的 变量 称 为 形 
参 ， 不 要 大 惊 小 怪 。 


动手 试 一 试 

练习 8-1: 消息 ”编写 一 个 名 为 display_message() 的 函 
数 ， 它 打印 一 个 句子 ， 指 出 你 在 本 章 学 的 是 什么 。 调 用 这 个 函 
数 ， 确 认 显 示 的 消息 正确 无 误 。 


练习 8-2: 喜欢 的 图 书 ”编写 一 个 名 为 favorite_book() 的 
函数 ， 其 中 包含 一 个 名 为 title 的 形 参 。 这 个 函数 打印 一 条 消 
恩 ;- 下 面 是 一 个 例子 8 


One of my favorite books is Alice in Wonderland. 


调用 这 个 函数 ， 并 将 一 本 图 书 的 名 称 作 为 实 参 传递 给 它 。 


8.2 ”传递 实 参 


图 数 定义 中 可 能 包含 多 个 形 参 ， 因 此 函数 调用 中 也 可 能 包含 多 个 实 
参 。 向 函数 传递 实 参 的 方式 很 多 可 使 用 位 置 实 参 ， 这 要 求实 参 
的 顺序 与 形 参 的 顺序 相同 ， 也 可 使 用 关键 字 实 参 ， 其 中 每 个 实 参 
都 由 变量 名 和 值 组 成 ， 还 可 使 用 列表 和 字典 。 下 面 依次 介绍 这 些 方 


式 。 


8.2.1 位 置 实 参 


调用 函数 时 ， Python 必须 将 函数 调 用 中 的 每 个 实 参 都 关联 到 函数 定 
义 中 的 一 个 形 参 。 为 此 ， 最 简单 的 关联 方式 是 基于 实 参 的 顺序 。 这 
种 关联 方式 和 和 为 位 秆 实 参 。 


为 明白 其 中 的 工作 原理 ， 来 看 一 个 显示 宠物 信息 的 函数 。 这 个 函数 
出 一 个 宠物 属于 哪 种 动物 以 及 它 叫 什么 名 字 ， 如 下 所 示 : 


pets.py 


@ def describe eh _type， pet_name ) : 
"" 显 示 宠 物 的 信息 。" 
print(f"\nI Fave a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


@ describe pet('hamster', 'harry') 


这 个 函数 的 定义 表明 ， 已 需要 一 种 动物 类 型 和 一 个 名 字 〈 见 @) 。 
0 _pet() 时 ， 需 要 按 顺 序 提供 一 种 动物 类 型 和 一 个 名 
。 例 如 ， 在 刚才 的 函数 调用 中 ， 实 参 "hamster ' 被 赋 给 形 参 
a _type ， 而 实 参 'harry' 被 赋 给 形 参 pet_name ( 见 @) 。 

在 函数 体内 ， 使 用 了 这 两 个 形 参 来 显示 宠物 的 信息 。 


输出 插 述 了 一 只 名 为 Harry 的 仓鼠 : 


I have a hamster. 
My hamster's name is Harry. 


a. 多 次 调用 函数 


可 以 根据 需要 调用 函数 任意 次 。 要 再 描述 一 个 宠物 ， 只 需 再 次 
调用 describe_pet() 即 可 : 


def describe _pet (animal. -types pet_name ) : 
" "显示 宠 物 的 信息 
print(f"\nI Dave a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet('hamster', 'harry') 
describe pet('dog', 'willie') 


第 二 次 调用 describe_pet() 函数 时 ， 辐 它 传递 了 实 参 'dog 
和 'willie' 。 与 第 一 次 调用 时 一 样 ，Python 将 实 参 "dog ' 关 
联 到 形 参 animal_type ， 并 将 实 参 'willie' 关联 a 到 形 参 
pet_name 。 与 前 面 一 样 ， 这 个 冰 数 元 成 了 任务 ， 但 打印 的 是 

一 条 名 为 Willie 的 小 狗 的 信息 。 至 此 ， 有 一 只 名 为 Harry 的 仓 
鼠 ， 还 有 一 条 名 为 Willie 的 小 狗 : 


I have a hamster. 
My hamster's name is Harry. 


I have a dog. 
My dog's name is Willie. 


多 次 调用 函数 是 一 种 效率 极 高 的 工作 方式 。 只 雷 在 函数 中 编写 
一 次 描述 老 物 的 代码 ， 然 后 每 当 需 要 描述 新 宠物 时 ， 都 调用 该 
国 数 并 癌 它 提供 新 宠物 的 信息 。 即 便 描 述 宠 物 的 代码 增加 到 了 
有 依然 只 需 使 用 一 行 调用 函数 的 代码 ， 就 可 描述 一 个 新 完 


在 函数 中 ， 可 根据 需要 使 用 任意 数量 的 位 置 实 参 ，Python 将 按 
顺序 将 函数 调用 中 的 实 参 关联 到 函数 定义 中 相应 的 形 参 ， 


b. 位 置 实 参 的 顺序 很 重要 


使 用 位 置 实 参 来 调用 函数 时 ， 如 果实 参 的 顺序 不 正确 ， 结 果 可 
能 出 乎 意料 : 


def describe pet(animal type, pet_name): 
""" 显 示 宠物 的 信息 。" 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet('harry', 'hamster') 


在 这 个 函数 调用 中 ， 先 指定 名 字 ， 再 指定 动物 类 型 。 由 于 实 
参 'harry' 在 前 ， 这 个 值 将 赋 给 形 参 animal_type 。 同 
理 ，'hamster' 将 赋 给 形 参 pet_name 。 结 果 是 有 一 个 名 为 
Hamster 的 harry: 


I _ have a harry. 
My harry's name is Hamster. 


如 果 你 得 到 的 结果 像 上 面 一 样 可 笑 ， 请 确认 函数 调用 中 实 参 的 


顺序 与 函数 定义 中 形 参 的 顺序 一 致 。 


8.2.2 ”关键 字 实 参 

关键 字 实 参 是 传递 给 函数 的 名 称 值 对 。 因 为 直接 在 实 参 中 将 名 称 
和 值 关联 起 来 ， 所 以 癌 函 数 传递 实 参 时 不 会 混淆 (不 会 得 到 名 为 
Hamster 的 harry 这 样 的 结果 ) 。 关 键 字 实 参 让 你 无 须 考虑 函数 调用 
中 的 实 参 顺序 ， 还 清楚 地 指出 了 函数 调用 中 各 个 值 的 用 途 。 


下 面 来 重新 编写 pets.py， 在 其 中 使 用 关键 字 实 参 来 调 
用 describe pet(): 


def describe pet(animal type, pet_name): 


"" 显 示 宠 物 的 信息 。""" 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet(animal type='hamster', pet name="'harry') 


函数 describe_pet() 还 和 之 前 一 样 ， 但 调用 这 个 函数 时 ， 向 
Python 明确 地 指出 了 各 个 实 参 对 应 的 形 参 。 看 到 这 个 函数 调用 时 ， 
Python 知道 应 该 将 实 参 'hamster' 和 'harry' 分 别 赋 给 形 参 
animal_ type 和 pet_name 。 输 出 正确 无 误 ， 指 出 有 一 只 名 为 
Harry 的 仓 忌 。 


关键 字 实 参 的 顺序 无 关 紧 要 ， 因 为 Python 知 道 各 个 值 该 赋 给 哪个 形 
参 。 下 面 两 个 函数 调用 是 等 效 的 : 


describe pet(animal type='hamster', pet name="'harry') 
describe pet(pet name='harry', animal type='hamster') 


注意 ”使 用 关键 字 实 参 时 ， 务 必 准 确 指 定 函 数 定义 中 的 形 参 
名 。 


8.2.3 ”默认 值 


编写 函数 时 ， 可 给 每 个 形 参 指定 默认 值 。 在 调用 函数 中 给 形 参 提 
供 了 实 参 时 ，Python 将 使 用 指定 的 实 参 值 ， 否 则 ， 将 使 用 形 参 的 默 
认 值 。 因 此 ， 给 形 参 指定 默认 值 后 ， 可 在 函数 调用 中 省 略 相 应 的 实 
使 用 默认 值 可 简化 函数 调用 ， 还 可 清楚 地 指出 函数 的 典型 用 
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例如 ， 如 果 你 发 现 调 用 describe_pet() 时 ， 描 述 的 大 多 是 小 狗 ， 
就 可 将 形 参 animal_type 的 默认 值 设 置 为 'dog' 。 这 样 ， 调 
用 describe_pet() 来 描述 小 狗 时 ， 就 可 不 提供 这 种 信息 : 


def describe pet(pet name, animal type= 'dog ') : 


"" 显 示 宠 物 的 信息 。""" 
print(f"\nI have a {animal type}.") 


print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet(pet name="'willie') 


这 里 修改 了 函数 describe_pet() 的 定义 ， 在 其 中 给 形 参 
animal_type 指定 了 默认 值 'dog' 。 这 样 ， 调 用 这 个 函数 时 ， 如 
朱 没 有 给 animal type 指定 值 ，Python 就 将 把 这 个 形 参 设置 

为 "dog' 


I have a dog. 
My dog's name is Willie. 


请 注意 ， 在 这 个 函数 的 定义 中 ， 修 改 了 形 参 的 排列 顺序 。 因 为 给 
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以 在 函数 调用 中 只 包含 一 然而 ，Python 依 
然 将 这 个 实 参 视 为 位 置 实 参 ; 因此 如 果 函 数 调用 中 内 含 宠物 的 名 
字 ， 这 个 实 参 将 关联 到 函数 定义 中 的 第 一 个 形 参 。 这 就 是 需要 

将 pet_name 放 在 形 参 列 表 开头 的 原因 。 


现在 ， 使 用 这 个 函数 的 最 简单 方式 是 在 函数 调用 中 只 提供 小 狗 的 名 
字 : 


describe pet('willie') 


这 个 函数 调用 的 输出 与 前 一 个 示例 相同 。 只 提供 了 一 个 实 

参 'willie"' ， 这 个 实 参 将 关联 到 函数 定义 中 的 第 一 个 形 参 
pet_name 。 由 于 没有 给 animal_type 提供 实 参 ，Python 将 使 用 默 
认 值 "dog ' 。 


如 果 要 描述 的 动物 不 是 小 狗 ， 可 使 用 类 似 于 下 面 的 函数 调用 : 


describe pet(pet name='harry', animal type='hamster') 


由 于 显 式 地 给 animal_type 提供 了 实 参 ，Python 将 忽略 这 个 形 参 的 
默认 值 。 


注意 ”使 用 默认 值 时 ， 必 须 先 在 形 参 列表 中 列 出 没有 默认 值 
的 形 参 ， 再 列 出 有 默认 值 的 实 参 。 这 让 Python 依 然 能 够 正确 地 
解读 位 置 实 参 。 


8.2.4 ”等 效 的 函数 调用 
鉴于 可 泥 合 使 用 位 置 实 参 、 关 键 字 实 参 和 默认 值 ， 通 常 有 多 种 等 效 


的 函数 调用 方式 。 请 看 下 面 对 函 数 describe_pet() 的 定义 ， 其 中 
给 一 个 形 参 提供 了 默认 值 : 


def describe pet(pet name, animal type= 'dog ') : 


基于 这 种 定义 ， 在 任何 情况 下 都 必须 给 pet_name 提供 实 参 。 指 定 
该 实 参 时 可 采用 位 置 方式 ， 也 可 采用 关键 字 方式 。 如 果 要 描述 的 动 
物 不 是 小 狗 ， 还 必须 在 函数 调用 中 给 animal_type 提供 实 参 。 同 
样 ， 指 定 该 实 参 时 可 以 采用 位 置 方式 ， 也 可 采用 关键 字 方 式 。 


下 面 对 这 个 函数 的 所 有 调用 都 可 行 : 


# 一 条 名 为 Willie 的 小 狗 。 
describe pet('willie') 
describe pet(pet name="'willie') 


# 一 只 名 为 Harry 的 仓鼠 。 


describe pet('harry', 'hamster') 
describe pet(pet name='harry', animal type='hamster') 
describe pet(animal type='hamster', pet name="'harry') 


这 些 函 数 调用 的 输出 与 前 面 的 示例 相同 。 


注意 使 用 哪 种 调用 方式 无 关 紧 要 ， 只 要 函数 调用 能 生成 你 
期 望 的 输出 就 行 。 使 用 对 你 来 说 最 容易 理解 的 调用 方式 即 可 。 


8.2.5 ”避免 实 参 错 误 


等 你 开始 使 用 函数 后 ， 如 果 遇 到 实 参 不 匹配 错误 ， 不 要 大 惊 小 怪 。 
你 提供 的 实 参 多 于 或 少 于 函数 完成 工作 所 需 的 信息 时 ， 将 出 现实 参 
不 匹配 错误 。 例 如 ， 如 果 调 用 冰 数 describe_pet() 时 没有 指定 任 
何 实 参 ， 结 果 将 如 何 呢 ? 


def describe pet(animal _ type，pet_name ) : 
""" 显 示 宠物 的 信息 。" 
print(f"\nI have a {animal type}.") 
print(f"My {animal type}'s name is {pet name.title()}.") 


describe pet() 


Python 发 现 该 函数 调用 缺少 必要 的 信息 ，traceback 指 出 了 这 一 反 : 


Traceback (most recent call last): 
@ File "pets.py", line 6, in <module> 
@ describe pet() 


日 TypeError: describe pet() missing 2 required positional arguments: ' 
type' and "pet_name 


在 和 @@ 处 ，traceback 指 出 了 问题 出 在 什么 地 方 ， 让 我 们 能 够 回 过 头 去 
找 出 函数 调用 中 的 错误 。 在 入 处， 指出 了 导致 问题 的 图 数 调 用 。 在 
合 处 ，traceback 指 出 该 函数 调用 少 了 两 个 实 参 ， 并 指出 了 相应 形 参 
的 名 称 。 如 果 这 个 函数 存储 在 一 个 独立 的 文件 中 ， 我 们 也 许 无 须 打 
开 这 个 文件 并 碍 看 函数 的 代码 ， 束 能 重新 正确 地 编写 函数 调用 。 


Python 读 取 函数 的 代码 并 指出 需要 为 哪些 形 参 提供 实 参 ， 这 提供 了 
极 大 的 帮助 。 这 也 是 应 该 给 变量 和 函数 指定 描述 性 名 称 的 另 一 个 原 
因 : 如 果 这 样 做 了 ， 那 么 无 论 对 于 你 ， 还 是 可 能 使 用 你 编写 的 代码 
的 其 他 任何 人 来 说 ，Python 提 供 的 错误 消 恩 都 将 更 帮助 。 


如 果 提 供 的 实 参 太 多 ， 将 出 现 类 似 的 traceback， 帮 助 你 确保 函数 调 
用 和 函数 定义 匹配 。 


动手 试 一 斌 


练习 8-3: T 恤 ”编写 一 个 名 为 make_shirt() 的 函数 ， 它 接受 
一 个 尺码 以 及 要 印 到 T 恤 上 的 字样 。 这 个 函数 应 打印 一 个 句 
子 ， 概 要 地 说 明 T 恤 的 尺码 和 字样 。 


使 用 位 置 实 参 调用 该 函数 来 制作 一 件 IT 恤 ， 再 使 用 关键 字 实 参 
来 调用 这 个 函数 。 


练习 8-4: 大 号 工作 ”修改 函数 make_shirt() ， 使 其 在 默认 
情况 下 制作 一 件 印 有 “I love Python 字样 的 大 号 T 恤 。 调 用 这 个 
函数 来 制作 : 一 件 印 有 默认 字样 的 大 号 T 恤 ， 一 件 印 有 默认 字 
样 的 中 号 T 恤 ， 以 及 一 件 印 有 其 他 字样 的 T 恤 《尺码 无 关 紧 
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练习 8-5: 城市 ”编写 一 个 名 为 describe_city() 的 函数 ， 它 
接受 一 座 城市 的 名 字 以 及 该 城市 所 属 的 国家 。 这 个 函数 应 打印 
一 个 简单 的 多 了 于; 下面 是 一 个 例子 


Reykjavik is in Iceland. 


给 用 于 存储 国家 的 形 参 指定 默认 值 。 为 三 座 不 同 的 城市 调用 这 
个 函数 ， 且 其 中 至 少 有 一 座 城市 不 属于 默认 国家 。 


8.3 返回 值 


函数 并 非 总 是 直接 显示 输出 ， 它 还 可 以 处 理 一 些 数据 ， 并 返回 一 个 
或 一 组 值 。 函 数 返回 的 值 称 为 返回 值 。 在 函数 中 ， 可 使 用 return 
语句 将 值 返回 到 调用 函数 的 代码 行 。 返 回 值 让 你 能 够 将 程序 的 大 部 
分 繁重 工作 移 到 函数 中 去 完成 ， 从 而 简化 主 程序 。 


8.3.1 返回 简单 值 
下 面 来 看 一 个 函数 ， 它 接受 名 和 姓 并 返回 整洁 的 姓名 : 
formatted_name.py 


@ def get formatted name(first name, last_ name): 
""" 返 回 整洁 的 姓名 。""" 

@ full name = f"{first name} {last name}" 

日 return full name.title() 


@ musician = get formatted name('jimi', 'hendrix') 
print(musician) 


函数 get_formatted_name() 的 定义 通过 形 参 接受 名 和 姓 ( 见 
@) 。 它 将 姓 和 名 合 而 为 一 ， 在 中 间 加 上 一 个 空格 ， 并 将 结果 赋 给 
变量 full_name ( 见 @) 。 人 然后， 将 full_name 的 值 转换 为 首 字 
母 大 写 格 式 ， 并 将 结果 返回 到 函数 调用 行 ( 见 @) 。 


调用 返回 值 的 函数 时 ， 需 要 提供 一 个 变量 ， 以 便 将 返回 的 值 赋 给 


它 。 在 这 里 ， 将 返回 值 赋 给 了 变量 musician ( 见 人 全) 。 输 出 为 整 
洁 的 姓名 : 


原本 只 需 编 写 下 面 的 代码 就 可 输出 整洁 的 姓名 ， 相 比 于 此 ， 前 面 做 
的 工作 好 像 太 多 了 : 


print("Jimi Hendrix") 


但 在 需要 分 别 存 储 大 量 名 和 姓 的 大 型 程序 中 ， 像 
get_formatted_name() 这 样 的 函数 非常 有 用 。 可 以 分 别 存 储 名 
和 姓 ， 每 当 需 要 显示 姓名 时 都 调用 这 个 函数 。 


8.3.2 ”让 实 参 变 成 可 选 的 


有 时 候 ， 需 要 让 实 参 变 成 可 选 的 ， 这 样 使 用 函数 的 人 就 能 只 在 必要 
时 提供 额外 的 信息 。 可 使 用 默认 值 来 让 实 参 变 成 可 选 的 。 


例如 ， 假 设 要 扩展 函数 get_formatted_name() ， 使 其 同时 处 理 
中 间 名 。 为 此 ， 可 将 其 修改 成 类 似 于 下 面 这 样 : 


def get formatted name(first name, middle name, last name): 
“" "返回 整洁 的 姓名 。""" 
full name = f"{first name} {middle name} {last name}" 
return full name.title() 


musician = get formatted name('john', 'lee', 'hooker') 
print(musician) 


只 要 同时 提供 名 、 中 间 名 和 姓 ， 这 个 函数 就 能 正确 运行 。 它 根据 这 
三 部 分 创建 一 个 字符 串 ， 在 适当 的 地 方 加 上 空格 ， 并 将 结果 转换 为 
首 字 和 母 大 写 格式 : 


John Lee Hooker 


并 非 所 有 的 人 都 有 中 间 名 ， 但 如 果 调 用 这 个 函数 时 只 提供 了 名 和 
姓 ， 它 将 不 能 正确 运行 。 为 了 让 中 间 名 变 成 可 选 的 ， 可 给 形 参 
middle_name 指定 一 个 空 的 默认 值 ， 并 在 用 户 没有 提供 中 间 名 时 
不 使 用 这 个 形 参 。 为 让 get_formatted_name() 在 没有 提供 中 间 
名 时 依然 可 行 ， 可 将 形 参 middle_name 的 默认 值 设 置 为 空 字符 
串 ， 并 将 其 移 到 形 参 列 表 的 末尾 : 


@ def get formatted name(first name, last name, middle name="'): 
"" "返回 整洁 的 姓名 。""" 
@ if middle_name : 
full name = f"{first name} {middle name} {last name}" 
日 else: 
full name = f"{first name} {last name}" 
return full name.title() 


musician = get formatted name('jimi', 'hendrix') 
print(musician) 


@ musician = get formatted name('john', 'hooker', 'lee') 
print(musician) 


在 本 例 中 ， 姓 名 是 根据 三 个 可 能 提供 的 部 分 创建 的 。 由 于 人 都 有 名 
和 姓 ， 因 此 在 函数 定义 中 首先 列 出 了 这 两 个 形 参 。 中 间 名 是 可 选 
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符 串 〈 见 @@) 。 


在 函数 体 中 ， 检 查 是 否 提供 了 中 间 名 。Python 将 非 空 字符 串 解 读 

为 True ， 因 此 如 果 函 数 调 用 中 提供 了 中 间 名 ，if middle_name 

将 为 True ( 见 人 @) 。 如 果 提 供 了 中 间 名 ， 就 将 名 、 中 间 名 和 姓 合 
并 为 姓名 ， 再 将 其 修改 为 首 字 母 大 写 格式 ， 并 返回 到 函数 调用 行 。 
在 函数 调用 行 ， 将 返回 的 值 赋 给 变量 musician ， 然 后 这 个 变量 的 
值 被 打印 出 来 。 如 果 没 有 提供 中 间 名 ，middle_name 将 为 空 字符 
串 ， 导 至 if 测试 未 通过 ， 进 而 执行 else 代码 块 ( 见 @) : 只 使 用 
名 和 姓 来 生成 姓名 ， 并 将 格式 设置 好 的 姓名 返回 给 函数 调用 行 。 在 
函数 调用 行 ， 将 返回 的 值 赋 给 变量 musician ， 然 后 这 个 变量 的 值 
被 打印 出 来 。 

调用 这 个 函数 时 ， 如 果 只 想 指 定名 和 姓 ， 调 用 起 来 将 非常 简单 。 如 
果 还 要 指定 中 间 名 ， 就 必须 确保 它 是 最 后 一 个 实 参 ， 这 样 Python 才 
能 正确 地 将 位 置 实 参 关 联 到 形 参 〈 见 @@) . 


这 个 修改 后 的 版 本 不 仅 适 用 于 只 有 名 和 姓 的 人 ， 而 且 适 用 于 还 有 中 
间 名 的 人 : 


Jimi Hendrix 
John Lee Hooker 


和 同时 确保 函数 调用 尽 可 能 
简单 。 


8.3.3 ”返回 字典 


函数 可 返回 任何 类 型 的 值 ， 包 括 列表 和 字典 等 较 复杂 的 数据 结构 。 
例如 ， 下 面 的 函数 接受 姓名 的 组 成 部 分 ， 并 返回 一 个 表示 人 的 字 


人 


person.py 


def build person(first name, last name): 
“"" 返 回 一 个 字典 ， 其 中 包含 有 关 一 个 人 的 信息 。*"" 
person = {'first': first name, 'last': last name} 


return person 


musician = build person('jimi', 'hendrix') 
@ print(musician) 


函数 build_person() 接受 名 和 姓 ， 并 将 这 些 值 放 到 字典 中 ( 见 
@) 。 存储 first_name 的 值 时 ， 使 用 的 键 为 "first' ， 而 存储 
last_name 的 值 时 ， 使 用 的 键 为 "last' 。 最 后 ， 返 回 表 示人 的 整 
个 字典 〔( 见 人 @) 。 在 全 处 ， 打 印 这 个 返回 的 值 ， 此 时 原来 的 两 项 文 
本 信息 存储 在 一 个 字典 中 : 


{'first': 'jimi', 'last': 'hendrix'} 


这 个 函数 接受 简单 的 文本 信息 ， 并 将 其 放 在 一 个 更 合适 的 数据 结构 
中 ， 让 你 不 仅 能 打印 这 些 信息 ， 还 能 以 其 他 方式 处 理 它 们 。 当 前 ， 
字符 串 'jimi' 和 "hendrix' 被 标记 为 名 和 姓 。 你 可 以 轻松 地 扩展 
这 个 函数 ， 使 其 接受 可 选 值 ， 如 中 间 名 、 年 龄 、 职 业 或 其 他 任何 要 
存储 的 信息 。 例 如 ， 下 面 的 修改 让 你 能 存储 年 龄 : 


def build person(first name, last name, age=None): 
""" 返 回 一 个 字典 ， 其 中 包含 有 关 一 个 人 的 信息 。""" 
person = {'first': first name, 'last': last name} 
if age: 
person['age'|] = age 


return person 


musician = build person('jimi', 'hendrix', age=27) 
print(musician) 


在 函数 定义 中 ， 新 增 了 一 个 可 选 形 参 age ， 并 将 其 默认 值 设置 为 特 
殊 值 None 〈 表 示 变 量 没 有 值 ) 。 可 将 None 视 为 占 位 值 。 在 条 件 测 
试 中 ，None 相当 于 False 。 如 果 函 数 调用 中 包含 形 参 age 的 值 ， 
这 个 值 将 被 存储 到 字典 中 。 在 任何 情况 下 ， 这 个 函数 都 会 存储 人 的 
姓名 ， 但 可 进行 修改 ， 使 其 同时 存储 有 关 人 的 其 他 信息 。 


8.3.4 结合 使 用 函数 和 while 循环 
可 将 函数 同 本 书 前 面 介 绍 的 任何 Python 结构 结合 起 来 使 用 。 例 如 ， 


下 面 将 结合 使 用 函数 get_formatted_name() 和 while 循环 ， 以 
更 正式 的 方式 问候 用 户 。 下 面 尝试 使 用 名 和 姓 跟 用 户 打 招呼 : 


greeter.py 


def get formatted name(first name, last _ name): 
“" "返回 整洁 的 姓名 。""" 
full name = f"{first name} {last name}" 
return full name.title() 


# 这 是 一 个 无 限 循 环 ! 

while True: 
print("\nplease tell me your name:") 
f name = input("First name: ") 
1] name = input("Last name: ") 


formatted name = get formatted name(f_ name, 1_name) 
print(f"\nHello, {formatted name}!") 


在 本 例 中 ， 使 用 的 是 get_formatted_name() 的 简单 版 本 ， 不 涉 
a 0 
( 风 @)， 


但 这 个 while 循环 存在 一 个 问题 : 没有 定义 退出 条 件 。 请 用 户 提供 
一 系列 输入 时 ， 该 在 什么 地 方 提 供 退 出 途径 呢 ? 要 让 用 户 能 够 尽 可 
能 容易 地 退出 ， 因 此 每 次 提示 用 户 输入 时 ， 痢 应 提供 退出 途径 。 
次 提示 用 户 输入 时 ， 都 使 用 break 语句 提供 退出 循环 的 简单 途径 : 


def get formatted name(first name, last name): 
""" 返 回 整 洁 的 姓名 。""" 
full name = f"{first name} {last name}" 
return full name.title() 


while True: 
print("\nPplease tell me your name:") 
print("(enter 'q' at any time to quit)") 


f_ name = input("First name: ") 


if f _ name == 'q : 
break 


1_name = input("Last name: ") 
if 1 name == 'q': 
break 


formatted name = get formatted name(f_ name, 1_name) 
print(f"\nHello, {formatted name}!") 


我 们 添加 了 一 条 消息 来 告诉 用 户 如 何 退 出 ， 然 后 在 每 次 提示 用 户 输 
入 时 ， 都 检查 他 输入 的 是 否 是 退出 值 。 如 果 是 ， 就 退出 循环 。 现 
在 ， 这 个 程序 将 不 断 地 问候 ， 直 a 到 用 户 输 入 的 姓 或 名 为 'q'": 


Please tell me your name: 
(enter 'q' at any time to quit) 
First name: eric 

Last name: matthes 


Hello, Eric Matthes! 


Please tell me your name: 


(enter 'q' at any time to quit) 
First name: q 
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练习 8-6: 城市 名 ”编写 一 个 名 为 city_ gouty 的 函数 ， 
它 接受 城市 的 名 称 及 其 所 属 的 国家 。 这 个 函数 应 返回 一 个 格式 
类 似 于 下 面 的 字符 串 : 


"Santiago, Chile" 


和 函数 ， 并 打印 它 返 回 的 


练习 8-7: 专辑 ”编写 一 个 名 为 make_album( ) 的 函数 ， 它 创 
建 一 个 描述 音乐 专辑 的 字典 。 这 个 函数 应 接 溉 歌手 的 名 字 和 专 
辑 名 ， 并 返回 一 个 包含 这 两 项 信息 的 字典 。 使 用 这 个 函数 创建 
三 个 表示 不 同 专辑 的 字典 ， 并 打印 每 个 返回 的 值 ， 以 核实 字典 
正确 地 存储 了 专辑 的 信息 。 


给 函数 make_album() 添加 一 个 默认 值 为 None 的 可 选 形 参 ， 
以 便 存储 专辑 包含 的 歌曲 数 。 如 果 调 用 这 个 函数 时 指定 了 歌曲 
数 ， 就 将 该 值 添加 到 表示 专辑 的 字典 中 。 调 用 这 个 函数 ， 并 至 
少 在 一 次 调用 中 指定 专辑 包含 的 歌曲 数 。 


练习 8-8: 用 户 的 专辑 ”在 为 完成 练习 8-7 编 写 的 程序 中 ， 编 写 
一 个 while 循环 ， 让 用 户 输入 专辑 的 歌手 和 名 称 。 获 取 这 些 信 
息 后 ， 使 用 它们 来 调用 函数 make_album() 并 将 创建 的 字典 打 
印 出 来 。 在 这 个 while 循环 中 ， 务 必 提 供 退出 途径 。 


8.4 传递 列表 


你 经 常会 发 现 ， 癌 函数 传递 列表 很 有 用 ， 其 中 包含 的 可 能 是 名 字 、 
数 或 更 复杂 的 对 象 《 如 字典 ) 。 将 列表 传递 给 函数 后 ， 函 数 就 能 直 
接 访 问 其 内 容 。 下 面 使 用 函数 来 提高 处 理 列 表 的 效率 。 


假设 有 一 个 用 户 列 表 ， 我 们 要 问候 其 中 的 每 位 用 户 。 下 面 的 示例 将 
包含 名 字 的 列表 传递 给 一 个 名 为 greet_users() 的 函数 ， 这 个 函 
数 问候 列表 中 的 每 个 人 : 


greet_users.py 


def greet users(names): 
"" "向 列表 中 的 每 位 用 户 发 出 简单 的 问候 。""" 


for name in names: 


msg = f"Hello, {name.title()}!" 
print(msg) 


@ usernames = ['hannah', 'ty', "margot '] 
greet_ users(usernames) 


我 们 将 greet_users() 定义 为 接受 一 个 名 字 列 表 ， 并 将 其 赋 给 形 
参 names 。 这 个 函数 过 历 收 到 的 列表 ， 并 对 其 中 的 每 位 用 户 打印 一 
条 问候 语 。@ 处 定义 了 一 个 用 户 列 表 usernames ， 然 后 调 

用 greet_users() 并 将 该 列表 传递 给 它 : 


Hello, Hannah! 
Hello, Ty! 


Hello, Margot! 


输出 完全 符合 预期 。 每 位 用 户 都 看 到 了 一 条 个 性 化 的 问候 语 。 每 当 
再 要 问候 一 组 用 户 时 ， 都 可 调用 这 个 函数 。 


8.4.1 在 函数 中 修改 列表 


将 列表 传递 给 函数 后 ， 函 数 束 可 对 其 进行 修改 。 在 函数 中 对 这 个 列 
Re 这 让 你 能 够 高 效 地 处 理 大 量 数 
丘 。 


来 看 一 家 为 用 户 提交 的 设计 制作 3D 打 印 模型 的 公司 。 需 要 打印 的 
设计 存储 在 一 个 列表 中 ， 打 印 后 将 移 到 为 一 个 列表 中 。 下 面 是 在 不 
使 用 函数 的 情况 下 模拟 这 个 过 程 的 代码 : 


printing_models.py 


# 首先 创建 一 个 列表 ， 其 中 包含 一 些 要 打印 的 设计 。 
unprinted designs = ['phone case', 'robot pendant', 'dodecahedron ' ] 
completed models = [|] 


# 模拟 打印 每 个 设计 ， 直 到 没有 未 打印 的 设计 为 止 。 
# 打印 每 个 设计 后 ， 都 将 其 移 到 列表 completed_models 中 。 
while unprinted designs: 

current design = unprinted designs.pop() 


print(f"Printing model: {current design}") 
completed models.append(current design) 


# 显示 打印 好 的 所 有 模型 。 

print("\nThe following models have been printed:") 

for completed model in completed models: 
print(completed model) 


这 个 程序 首先 创建 一 个 需要 打印 的 设计 列表 ， 以 及 一 个 名 

为 completed_models 的 空 列表 ， 每 个 设计 打印 后 都 将 移 到 其 中 。 
只 要 列表 unprinted_designs 中 还 有 设计 ，while 循环 就 模拟 打 
印 设计 的 过 程 : 从 该 列表 末尾 删除 一 个 设计 ， 将 其 赋 给 变量 
current_design ， 并 显示 一 条 消息 指出 正在 打印 当前 的 设计 ， 然 
后 将 该 设计 加 入 到 列表 completed_models 中 。 循 环 结束 后 ， 显 示 
已 打印 的 所 有 设计 : 


Printing model: dodecahedron 
Printing model: robot pendant 
Printing model: phone case 


The following models have been printed : 
dodecahedron 


robot pendant 
phone case 


为 重新 组 织 这 些 代 码 ， 可 编写 两 个 图 数 ， 每 个 都 做 一 件 共 体 的 工 
作 。 大 部 分 代码 与 原来 相同 ， 只 是 效率 更 高 。 第 一 个 函数 负责 处 理 
打印 设计 的 工作 ， 第 二 个 概述 打印 了 哪些 设计 : 


@ def print models(unprinted designs, completed models): 


模拟 打印 每 个 设计 ， 直 到 没有 未 打印 的 设计 为 止 。 
打印 每 个 设计 后 ， 都 将 其 移 到 列表 completed_models 中 。 


while unprinted designs: 
current design = unprinted designs.pop() 
print(f"Printing model: {current design}") 
completed models.append(current design) 


@ def show completed models(completed models): 
"" 显 示 打 印 好 的 所 有 模型 。""" 
print("\nThe following models have been printed:") 
for completed model in completed models: 
print(completed model) 


unprinted designs = ['phone case', 'robot pendant', 'dodecahedron'] 
completed models = [] 


print models(unprinted designs, completed models) 
show_ completed models(completed models) 


@@ 处 定义 了 函数 print_models() ， 它 包含 两 个 形 参 : 一 个 需要 打 
印 的 设计 列表 和 一 个 打印 好 的 模型 列表 。 给 定 这 两 个 列表 ， 该 函数 
模拟 打印 每 个 设计 的 过 程 : 将 设计 逐个 从 未 打印 的 设计 列表 中 取 

出 ， 并 加 入 打印 好 的 模型 列表 中 。 灸 处 定义 了 函 

数 show_completed_models() ， 它 包含 一 个 形 参 : 打印 好 的 模型 
列表 。 给 定 这 个 列表 ， 函 数 show_completed_models() 显示 打印 
出 来 的 每 个 模型 的 名 称 。 


这 个 程序 的 输出 与 未 使 用 函数 的 版 本 相同 ， 但 组 织 更 为 有 序 。 完 成 
大 部 分 工作 的 代码 都 移 到 了 两 个 函数 中 ， 让 主 程序 更 容易 理解 。 只 


要 看 看 主 程序 ， 就 会 发 现 这 个 程序 的 功能 清晰 得 多 : 


unprinted designs = ['phone case', 'robot pendant', 'dodecahedron ' ] 
completed models = [|] 


print models(unprinted designs, completed models) 
show_completed models(completed models) 


我 们 创建 了 一 个 未 打印 的 设计 列表 ， 还 创建 了 一 个 空 列表 ， 用 于 存 
储 打 印 好 的 模型 。 接 下 来 ， 由 于 已 经 定义 了 两 个 函数 ， 只 需 调 用 它 
们 并 传 入 正确 的 实 参 即 可 。 我 们 调用 print_models() 并 回 它 传递 
两 个 列表 。 像 预期 一 样 ，print_models() 模拟 打印 设计 的 过 程 。 
接 下 来 ， 调 用 show_completed_models()， 并 将 打印 好 的 模型 列 
表 传 递 给 它 ， 让 其 能 够 指出 打印 了 哪些 模型 。 描 述 性 的 函数 名 让 别 
人 阅读 这 些 代码 时 也 能 明白 ， 尽 管 没 有 任何 注释 。 


相 比 于 没有 使 用 函数 的 版 本 ， 这 个 程序 更 容易 扩展 和 维护 。 如 果 以 
后 需要 打印 其 他 设计 ， 只 需 再 次 调用 print_models() 即 可 。 如 采 
发 现 需要 对 打印 代码 进行 修改 ， 只 需 修 改 这 些 代 码 一 次 ， 就 能 影响 
所 有 调用 该 函数 的 地 方 。 与 必须 分 别 修改 程序 的 多 个 地 方 相 比 ， 这 
种 修改 的 效率 更 高 。 


该 程序 还 演示 了 这 样 一 种 理念 : 每 个 函数 都 应 只 负责 一 项 具体 的 工 
作 。 第 一 个 函数 打印 每 个 设计 ， 第 二 个 显示 打印 好 的 模型 。 这 优 于 
使 用 一 个 函数 来 完成 这 两 项 工作 。 编 写 了 图 数 时 ， 如 果 发 现 它 执行 的 
任务 太 多 ， 请 尝试 将 这 些 代 码 划分 到 两 个 函数 中 。 列 筷 了 ， 总 是 可 
以 在 一 个 函数 中 调用 另 一 个 函数 ， 这 有 助 于 将 复杂 的 任务 划分 成 一 


系列 步骤 。 
8.4.2 ”禁止 函数 修改 列表 


有 时候， 需要 禁止 函数 修改 列表 。 例 如 ， 假 设 像 前 一 个 示例 那样 ， 
你 有 一 个 未 打印 的 设计 列表 ， 并 编写 了 一 个 函数 将 这 些 设计 移 到 打 
印 好 的 模型 列表 中 。 你 可 能 会 做 出 这 样 的 决定 : 即便 打印 好 了 所 有 
设计 ， 也 要 保留 原来 的 未 打印 的 设计 列表 ， 以 供 备案 。 但 由 于 你 将 
所 有 的 设计 都 移出 了 unprinted_designs ， 这 个 列表 变 成 了 空 

的 ， 原 来 的 列表 没有 了 。 为 解决 这 个 问题 ， 可 癌 函 数 传 递 列 表 的 副 


本 而 非 原件 。 这 样 ， 函 数 所 做 的 任何 修改 都 只 影响 副本 ， 而 原件 丝 
毫 不 受 影响 。 


要 将 列表 的 副本 传递 给 函数 ， 可 以 像 下 面 这 样 做 : 


function name(list name [:]) 


切片 表示 法 [:] 创建 列表 的 副本 。 在 printing_models.py 中 ， 如 果 不 
想 清空 未 打印 的 设计 列表 ， 可 像 下 面 这 样 调 用 print_models(): 


print models(unprinted designs[:], completed models) 


这 样 函数 print_models() 依然 能 够 完成 工作 ， 因 为 它 获得 了 所 有 
未 打印 的 设计 的 名 称 ， 但 使 用 的 是 列表 unprinted_designs 的 副 
本 ， 而 不 是 列表 unprinted_designs 本 身 。 像 以 前 一 样 ， 列 

表 completed_models 也 将 包含 打印 好 的 模型 的 名 称 ， 但 函数 所 做 
的 修改 不 会 影响 到 列表 unprinted_designs 。 


里 然 同 函数 传递 列表 的 副本 可 保留 原始 列表 的 内 容 ， 但 除非 有 充分 
的 理由 ， 梧 则 还 是 应 该 将 原始 列表 传递 给 函数 。 这 是 因为 让 函数 使 
用 现成 的 列表 可 避免 花 时 间 和 欠 存 创建 副本 ， 从 而 提高 效率 ， 在 处 
理 大 型 列表 时 尤其 如 此 。 
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练习 8-9: 消息 ”创建 一 个 列表 ， 其 中 包含 一 系列 简短 的 文本 
消息 。 将 该 列表 传递 给 一 个 名 为 show_messages() 的 函数 ， 
这 个 函数 会 打印 列表 中 的 每 条 文本 消息 。 


练习 8-10: 发 送 消息 ”在 你 为 完成 练习 8-9 而 编写 的 程序 中 ， 
编写 一 个 名 为 send_messages() 的 函数 ， 将 每 条 消息 都 打印 
出 来 并 移 到 一 个 名 为 sent_messages 的 列表 中 。 调 用 函 

数 send_messages() ， 再 将 两 个 列表 都 打印 出 来 ， 确 认 正 确 
地 移动 了 消息 。 


练习 8-11: 消息 归档 ”修改 你 为 完成 练习 8-10 而 编写 的 程序 ， 
在 调用 阔 数 send_messages() 时 ， 回 它 传递 消息 列表 的 副 
本 。 调 用 函数 send_messages() 后 ， 将 两 个 列表 都 打印 出 
来 ， 确 认 保 留 了 原始 列表 中 的 消息 。 


8.5 ”传递 任意 数量 的 实 参 


有 了 时候 ， 预 完 不 知道 函数 需要 接受 多 少 个 实 参 ， 好 在 Python 人 允许 函 
数 从 调用 语句 中 收集 任意 数量 的 实 参 。 


例如 ， 来 看 一 个 制作 比 桂 的 函数 ， 它 需要 接受 很 多 配料 ， 但 无 法 预 
先 确定 顾客 要 多 少 种 配料 。 下 面 的 函数 只 有 一 个 形 参 *toppings ， 
Pe 这 个 形 参 会 将 它们 统统 收入 赛 


pizza.py 


def make_ pizza(*toppings): 


""" 打 印 顾客 点 的 所 有 配料 。""" 
print(toppings) 


make_pizza('pepperoni') 
make_pizza('mushrooms', 'green peppers', 'extra cheese') 


形 参 名 *toppings 中 的 星 号 让 Python 创 建 一 个 名 为 toppings 的 空 
元 组 ， 并 将 收 到 的 所 有 值 都 封装 到 这 个 元 组 中 。 函 数 体 内 的 函数 调 
用 print() 通过 生成 输出 ， 证 明 Python 能 够 处 理 使 用 一 个 值 来 调用 
函数 的 情形 ， 也 能 处 理 使 用 三 个 值 来 调用 函数 的 情形 。 它 以 类 似 的 
方式 处 理 不 同 的 调用 。 注 意 ，Python 将 实 参 封装 到 一 个 元 组 中 ， 即 
便 函 数 只 收 到 一 个 值 : 


('pepperoni',) 
('mushrooms', 'green peppers', 'extra cheese') 


现在 ， 可 以 将 函数 调用 print() 替换 为 一 个 循环 ， 吉 历 配 料 列表 并 
对 顾客 点 的 比萨 进行 描述 : 


def make pizza(*toppings): 
""" 概 述 要 制作 的 比萨 。""" 


print("\nMaking a pizza with the following toppings:") 
for topping in toppings: 
print(f"- {topping}") 


make_pizza('pepperoni') 
make_pizza('mushrooms', 'green peppers', 'extra cheese') 


不 管 收 到 一 个 值 还 是 三 个 值 ， 这 个 函数 部 能 尼 善 处 理 : 


Making a pizza with the following toppings: 
- pepperoni 


Making a pizza with the following toppings: 
- mushrooms 

- green peppers 

- extra cheese 


不 管 函 数 收 到 的 实 参 是 多 少 个 ， 这 种 语法 都 管用 。 

8.5.1 结合 使 用 位 置 实 参 和 任意 数量 实 参 

如 果 要 让 函数 接受 不 同类 型 的 实 参 ， 必 须 在 函数 定义 中 将 接纳 任意 
数量 实 参 的 形 参 放 在 最 后 。Python 先 匹配 位 置 实 参 和 关键 字 实 参 ， 
再 将 余下 的 实 参 都 收集 到 最 后 一 个 形 参 中 。 


例如 ， 如 果 前 面 的 函数 还 需要 一 个 表示 比 院 尺 寸 的 形 参 ， 必 须 将 其 
放 在 形 参 *toppings 的 前 面 : 


def make pizza(size, *toppings): 
""" 概 述 要 制作 的 比萨 。""" 
print(f"\nMaking a {size}-inch pizza with the following toppings:" 
for topping in toppings: 
print(f"- {topping}") 


make_pizza(16, 'pepperoni') 
make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


基于 上 述 函 数 定义 ，Python 将 收 到 的 第 一 个 值 赋 给 形 参 size ， 并 
将 其 他 所 有 值 都 存储 在 元 组 toppings 中 。 在 函数 调用 中 ， 首 先 指 
定 表 示 比 桂 尺 寸 的 实 参 ， 再 根据 需要 指定 任意 数量 的 配料 。 


现在 ， 每 个 比 陡 都 有 了 尺寸 和 一 系列 配料 ， 而 且 这 些 信 息 按 正确 的 
顺序 打印 出 来 了 一 一 首先 是 尺寸 ， 然 后 是 配料 : 


Making a 16-inch pizza with the following toppings: 
- pepperoni 


Making a 12-inch pizza with the following toppings: 


- mushrooms 
- green peppers 
- extra cheese 


注意 ”你 经 常会 看 到 通用 形 参 名 *args ， 它 也 收集 任意 数量 
的 位 置 天 参 ， 


8.5.2 ”使 用 任意 数量 的 关键 字 实 参 


有 时 候 ， 需 要 接受 任意 数量 的 实 参 ， 但 预先 不 知道 传递 给 函数 的 会 
是 什么 样 的 信息 。 在 这 种 情况 下 ， 可 将 函数 编写 成 能 够 接受 任意 数 
量 的 键 值 对 一 一 调用 语句 提供 了 多 少 就 接受 多 少 。 一 个 这 样 的 示例 
是 创建 用 户 简 介 : 你 知道 将 收 到 有 关 用 户 的 信息 ， 但 不 确定 会 是 什 
么 样 的 信息 。 在 下 面 的 示例 中 函数 build_ profile() 接受 名 和 
姓 ， 还 接受 任意 数量 的 关键 字 实 参 : 


user_profile.py 


def build _profile(first, last, **user info): 


"创建 一 个 字典 ， 其 中 人 包含 我 们 知道 的 有 关 用 户 的 一 切 。 
@ user info['first name'] = first 
user info['last name'|] = last 
return user_ info 


user_ profile = build profile('albert', 'einstein', 
location="'princeton', 
field='physics') 
print(user_profile) 


函数 build_profile() 的 定义 要 求 提 供 名 和 姓 ， 同 时 人 允许 根据 需 
要 提供 任意 数量 的 名 称 值 对 。 形 参 **user_info 中 的 两 个 星 号 让 
Python 创 建 一 个 名 为 user_info 的 空 字典 ， 并 将 收 到 的 所 有 名 称 值 
对 都 放 到 这 个 字典 中 。 在 这 个 函数 中 ， 可 以 像 访 问 其 他 字典 那样 访 
问 user_info 中 的 名 称 值 对 。 


在 build_profile() 的 函数 体内 ， 将 名 和 姓 加 入 了 字 

典 user_info 中 ( 见 @) ， 因 为 总 是 会 从 用 户 那 里 收 到 这 两 项 信 
恩 ， 而 这 两 项 信息 没有 放 到 这 个 字典 中 。 接 下 来 ， 将 字 

典 user_info 返回 到 函数 调用 行 。 


我 们 调用 build_profile() ， 向 它 传递 名 ( "albert' ) 、 姓 
('einstein' ) 和 两 个 键 值 对 (location='princeton' 和 
field='physics' ) ， 并 将 返回 的 user_info 赋 给 变量 
user_profile ， 再 打印 该 变量 : 


{'location': 'princeton', 'field': “physics '， 
"first name': "albert'， 'last name': 'einstein'} 


在 这 里 ， 返 回 的 字典 包含 用 户 的 名 和 姓 ， 还 有 求学 的 地 方 和 所 学 专 
业 。 调 用 这 个 函数 时 ， 不 管 额 外 提供 多 少 个 键 值 对 ， 它 都 能 正确 地 
处 理 。 


编写 函数 时 ， 能 以 各 种 方式 混合 使 用 位 置 实 参 、 关 键 字 实 参 和 任意 
数量 的 实 参 。 知 道 这 些 实 参 类 型 大 有 人 神 益 ， 因 为 阅读 别人 编写 的 代 
码 时 经 常会 见 到 它们 。 要 正确 地 使 用 这 些 类 型 的 实 参 并 知道 其 使 用 
时 机 ， 需 要 经 过 一 定 的 练习 。 就 目前 而 言 ， 牢 记 使 用 最 简单 的 方法 
来 完成 任务 就 好 了 。 继 续 往 下 阅读 ， 你 就 会 知道 在 各 种 情况 下 哪 种 
方法 的 效率 最 高 。 


注意 你 经 党 会 看 到 形 参 名 **kwargs ， 它 用 于 收集 任意 数量 
的 关键 字 实 参 。 


动手 试 一 斌 


练习 8-12: 三 明治 ”编写 一 个 函数 ， 它 接受 顾客 要 在 三 明治 中 
添加 的 一 系列 食材 。 这 个 函数 只 有 一 个 形 参 ( 它 收集 函数 调用 
中 提供 的 所 有 食材 ， 并 打印 一 条 消息 ， 对 顾客 点 的 三 明治 进 
行 概述 。 调 用 这 个 函数 三 次 ， 每 次 部 提供 不 同 数量 的 实 参 。 


练习 8-13: 用 户 简介 复制 前 面 的 程序 user_profile.py， 在 其 
中 调用 build_profile() 来 创建 有 关 你 的 简介 。 调 用 这 个 函 
数 时 ， 指 定 你 的 名 和 姓 ， 以 及 三 个 描述 你 的 键 值 对 。 


练习 8-14: 汽车 ”编写 一 个 函数 ， 将 一 辆 汽车 的 信息 存储 在 字 
典 中 。 这 个 函数 总 是 接受 制造 商 和 型 号 ， 还 接受 任意 数量 的 关 


键 字 实 参 。 这 样 调用 该 函数 : 提供 必 不 可 少 的 信息 ， 以 及 两 个 
名 称 值 对 ， 如 颜色 和 选 装配 件 。 这 个 函数 必须 能 够 像 下 面 这 样 
进行 调用 : 


car = make_car('subaru' ， 'outback', color='blue', tow package=True) 


打印 返回 的 字典 ， 确 认 正 确 地 处 理 了 所 有 的 信息 。 


8.6 ”将 函数 存储 在 模块 中 


使 用 函数 的 优点 之 一 是 可 将 代码 块 与 主 程序 分 离 。 通 过 给 函数 指定 
描述 性 名 称 ， 可 让 主 程序 容易 理解 得 多 。 你 还 可 以 更 进一步 ， 将 函 
数 存储 在 称 为 模块 的 独立 文件 中 ， 再 将 模块 导入 到 主 程序 
import 语句 允许 在 当前 运行 的 程序 文件 中 使 用 模块 中 的 代 


通过 将 函数 存储 在 独立 的 文件 中 ， 可 隐藏 程序 代码 的 细节 ， 将 重点 
放 在 程序 的 高 层 逻 辑 上 。 这 还 能 让 你 在 众多 不 同 的 程序 中 重用 函 

数 。 将 函数 存储 在 独立 文件 中 后 ， 可 与 其 他 程序 员 共 享 这 些 文件 而 
不 是 0 知道 如 何 导 入 函数 还 能 让 你 使 用 其 他 程序 员 编 写 的 


导入 模块 的 方法 有 多 种 ， 下 面 对 每 种 进行 简要 的 介绍 。 

8.6.1 导入 整个 模块 

要 让 函数 是 可 导入 的 ， 得 先 创建 模 块 。 模 块 是 扩展 名 为 .py 的 文 
件 ， 包 含 要 导入 到 程序 中 的 代码 。 下 面 来 创建 一 个 包含 函 


数 make_pizza() 的 模块 。 为 此 ， 将 文件 pizza.py 中 除 函 
数 make_pizza() 之 外 的 其 他 代码 删除 : 


pizza.py 


def make pizza(size, “toppings) : 
"概述 要 制作 的 比 了 模 。""" 
print(f"\nMaking a {size}-inch pizza with the following toppings:" 


for topping in toppings: 
print(f"- {topping}") 


接 下 来 ， 在 pizza.py 所 在 的 目录 中 创建 一 个 名 为 making_pizzas.py 的 
文件 。 这 个 文件 导入 刚 创 建 的 模块 ， 再 调用 make_pizza() 两 次 : 


making_pizzas.py 


import pizza 


@ pizza.make pizza(16, 'pepperoni') 


pizza.make pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


Python 读 取 这 个 文件 时 ， 代 码 行 jmport pizza 让 Python 打开 文件 
pizza.py， 并 将 其 中 的 所 有 函数 都 复制 到 这 个 程序 中 。 你 看 不 到 复 
制 的 代码 ， 因 为 在 这 个 程序 即将 运行 时 ，Python 在 幕后 复制 了 这 些 
代码 。 你 只 需 知道 ， 在 making_pizzas.py 中 ， 可 使 用 pizza.py 中 定义 
的 所 有 函数 。 


要 调用 被 导入 模块 中 的 函数 ， 可 指定 被 导入 模块 的 名 称 pizza 和 函 
数 名 make_pizza() ， 并 用 句点 分 隔 ( 见 @) 。 这些 代码 的 输出 与 
没有 导入 模块 的 原始 程序 相同 : 


Making a 16-inch pizza with the following toppings : 
- pepperoni 


Making a 12-inch pizza with the following toppings: 


- mushrooms 


- green peppers 
- extra cheese 


这 了 就 是 一 种 导入 方法 : 只 需 编 写 一 条 import 语句 并 在 其 中 指定 模 
块 名 ， 就 可 在 程序 中 使 用 该 模块 中 的 所 有 函数 。 如 采 使 用 这 种 
import 语句 导入 了 名 为 module_name.py 的 整个 模块 ， 就 可 使 用 下 
面 的 语法 来 使 用 其 中 任何 一 个 函数 : 


module_name.function name() 


8.6.2 ”导入 特定 的 函数 
还 可 以 导入 模块 中 的 特定 函数 ， 这 种 导入 方法 的 语法 如 下 : 


from module name import function name 


遂 过 用 逗号 分 阳 函 数 名 ， 可 根据 需要 从 模块 中 导入 任意 数量 的 函 


from module name import function 68, function 1, function 2 


对 于 前 面 的 making_pizzas.py 示 例 ， 如 果 只 想 导 入 要 使 用 的 函数 ， 
代码 将 类 似 于 下 面 这 样 : 


from pizza import make pizza 


make_pizza(16, 'pepperoni') 


make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


使 用 这 种 语法 时 ， 调 用 函数 时 无 须 使 用 句点 。 由 于 在 import 语句 
中 显 式 地 导入 了 函数 make_pizza() ， 调 用 时 只 需 指定 其 名 称 即 
Ei 


8.6.3 ”使 用 as 给 函数 指定 别名 


如 果 要 导入 函数 的 名 称 可 能 与 程序 中 现 有 的 名 称 冲 突 ， 或 者 函数 的 
名 称 太 长 ， 可 指定 简短 而 独一无二 的 别名 : 函数 的 另 一 个 名 称 ， 
类 似 于 外 号 。 要 给 函数 取 这 种 特殊 外 号 ， 需 要 在 导入 它 时 指定 。 


下 面 给 函数 make_pizza() 指定 了 别名 mp() 。 这 是 在 import 语句 
中 使 用 make_pizza as mp 实现 的 ， 关 键 字 as 将 函数 重 命 名 为 指 
定 的 别名 : 


from pizza import make pizza as mp 


mp(16, 'pepperoni') 
mp(12, 'mushrooms', 'green peppers', 'extra cheese') 


| | 
上 面 的 jmport 语句 将 函数 make_pizza() 重 命名 为 mp() 。 在 这 个 
程序 中 ， 每 当 需 要 调用 make_pizza() 时 ， 都 可 简写 成 mp()。 
Python 将 运行 make_pizza() 中 的 代码 ， 避 免 与 这 个 程序 可 能 包含 
的 函数 make_pizza() 混淆 。 


指定 别名 的 通用 语法 如 下 : 


from module name import function name as fn 


8.6.4 ”使 用 as 给 模块 指定 别名 


还 可 以 给 模块 指定 别名 。 通 过 给 模块 指定 简短 的 别名 (如 给 模 
块 pizza 指定 别名 p ) ， 让 你 能 够 更 轻松 地 调用 模块 中 的 函数 。 相 
比 于 pizza.make_pizza() ，p.make_pizza() 更 为 简洁 : 


import pizza as p 


p.make_pizza(16， 'pepperoni') 


p.make_pizza(12, 'mushrooms', "green peppers', 'extra cheese') 


上 述 import 语句 给 模块 pizza 指定 了 别名 p ， 但 该 模块 中 所 有 也 
数 的 名 称 都 没 变 。 要 调用 函数 make_pizza() ， 可 编写 代 

码 p.make_pizza() 而 非 pizza.make_pizza() 。 这 样 不 仅 代码 更 
简洁 ， 还 让 你 不 用 再 关注 模块 名 ， 只 专注 于 摘 述 性 的 函数 名 。 这 些 
国 数 名 明确 指出 了 函数 的 功能 ， 对 于 理解 代码 而 言 ， 比 模块 名 更 重 
大 0o 


给 模块 指定 别名 的 通用 语法 如 下 : 


import module name as mn 


8.6.5 ”导入 模块 中 的 所 有 函数 
使 用 星 号 (* ) 运算 符 可 让 Python 导入 模块 中 的 所 有 函数 : 


from pizza import * 


make_pizza(16, 'pepperoni') 


make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese') 


import 语句 中 的 星 号 让 Python 将 模块 pizza 中 的 每 个 函数 都 复制 
到 这 个 程序 文件 中 。 由 于 导入 了 每 个 函数 ， 可 通过 名 称 来 调用 每 个 
函数 ， 而 无 须 使 用 句点 表示 法 。 然 而 ， 使 用 并 非 自 己 编写 的 大 型 模 
块 时 ， 最 好 不 要 采用 这 种 导入 方法 。 这 是 因为 如 果 模 块 中 有 函数 的 
名 称 与 当前 项 目 中 使 用 的 名 称 相 同 ， 可 能 导致 意 想 不 到 的 结果 : 
Python 可 能 遇 到 多 个 名 称 相 同 的 函数 或 变量 ， 进 而 覆盖 函数 ， 而 不 
是 分 别 导 入 所 有 的 函数 。 

最 佳 的 做 法 是 ， 要 么 只 导入 需要 使 用 的 函数 ， 要 么 导入 整个 模块 并 
使 用 句点 表示 法 。 这 让 代码 更 清晰 ， 更 容易 阅读 和 理解 。 这 里 之 所 
以 介绍 这 种 导入 方法 ， 只 是 想 让 你 在 阅读 别人 编写 的 代码 时 ， 能 够 
理解 类 似 于 下 面 的 jmport 语句 : 


from module name import * 


8.7 ”函数 编写 指 丙 


编写 函数 时 ， 需 要 牢记 几 个 细节 。 应 给 函数 指定 描述 性 名 称 ， 且 只 
在 其 中 使 用 小 写字 母 和 下 划 线 。 描 述 性 名 称 可 帮助 你 和 别人 明白 代 
码 想 要 做 什么 。 给 模块 命名 时 也 应 遵循 上 述 约定 。 

每 个 函数 都 应 包含 简要 地 阐述 其 功能 的 注释 。 该 注释 应 紧 跟 在 函数 
定义 后 面 ， 并 采用 文档 字符 串 格式 。 文 档 民 好 的 函数 让 其 他 程序 员 
只 需 阅 读 文档 字符 串 中 的 描述 就 能 够 使 用 它 。 他 们 完全 可 以 相信 代 
码 如 插 述 的 那样 运行 ， 并 且 只 要 知道 函数 的 名 称 、 需 要 的 实 参 以 及 
返回 值 的 类 型 ， 束 能 在 自己 的 程序 中 使 用 它 。 


给 形 参 指定 默认 值 时 ， 等 号 两 边 不 要 有 空格 : 


def function name(parameter 60, parameter 1='default value') 


对 于 函数 调用 中 的 关键 字 实 参 ， 也 应 遵循 这 种 约定 : 


function name(value 6，parameter 1='value ') 


PEP 8 建议 代码 行 的 长 度 不 要 超过 79 字 符 ， 这 样 只 要 编辑 器 窗口 适 
中 ， 束 能 看 到 整 行 代码 。 如 果 形 参 很 多 ， 导 致 函数 定义 的 长 度 超过 
了 了 79 字符 ， 可 在 函数 定义 中 输入 左 括 写 后 按 回 车 键 ， 并 在 下 一 行 按 
两 次 Tab 键 ， 从 而 将 形 参 列表 和 只 缩 进 一 层 的 函数 体 区 分 开 来 。 


大 多 数 编辑 器 会 目 动 对 齐 后 续 参 数列 表 行 ， 使 其 缩 进 程度 与 你 给 人 第 
一 个 参数 列表 行 指定 的 缩 进 程度 相同 : 


def function_name( 
Parameter 6，parameter 1, parameter 2， 
parameter 3, parameter 4, parameter 5) : 


function body... 


如 于 程序 或 模块 包含 多 个 函数 ， 可 使 用 两 个 空 行将 相 邻 的 函数 分 
开 ， 这 样 将 更 容易 知道 前 一 个 图 数 在 什么 地 方 结束 ， 下 一 个 函数 从 
什么 地 方 开始 。 


所 有 import 语句 都 应 放 在 文件 开头 。 唯 一 例外 的 情形 是 ， 在 文件 
开头 使 用 了 注释 来 揪 述 整个 程序 。 


动手 试 一 试 
练习 8-15: 打印 模型 ”将 示例 printing_models.py 中 的 函数 放 在 


一 个 名 为 printing_functions.py 的 文件 中 。 在 printing_models.py 
的 开头 编写 一 条 import 语句 ， 并 修改 该 文件 以 使 用 导入 的 函 
数 。 


练习 8-16: 导入 ”选择 一 个 你 编写 的 且 只 包含 一 个 函数 的 程 
序 ， 将 该 函数 放 在 另 一 个 文件 中 。 在 主 程序 文件 中 ， 使 用 下 述 
各 种 方法 导入 这 个 函数 ， 再 调用 它 : 


import module_name 

from module name import function name 

from module name import function name as fn 
import module name as mn 


from module name import * 


练习 8-17: 函数 编写 指南 ”选择 你 在 本 章 中 编写 的 三 个 程 
序 ， 确 保 它 们 遵循 了 本 市 介绍 的 函数 编写 指南 。 


8.8 ”小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 编写 函数 ， 以 及 如 何 传递 实 参 ， 让 函数 
能 够 访问 完成 其 工作 所 需 的 信息 ; 如 何 使 用 位 置 实 参 和 关键 字 实 

参 ， 以 及 如 何 接受 任意 数量 的 实 参 ， 显 示 输 出 的 函数 和 返回 值 的 函 
数 ， 如 何 将 函数 同 列表 、 字 典 、if 语句 和 while 循环 结合 起 来 使 
用 ; 如 何 将 函数 存储 在 称 为 模块 的 独立 文件 中 ， 让 程序 文件 更 简 

单 、 更 易于 理解 。 最 后 ， 你 学 习 了 函数 编写 指南 ， 遵 循 这 些 指南 可 
让 程序 始终 结构 民 好 ， 并 对 你 和 其 他 人 来 说 易于 阅读 。 


程序 员 的 目标 之 一 是 ， 编 写 简单 的 代码 来 完成 任务 ， 而 函数 有 助 于 
你 实现 这 样 的 目标 。 它 们 让 你 编写 好 代码 块 并 确定 其 能 够 正确 运行 
后 ， 就 可 置之不理 。 确 定 函 数 能 够 正确 地 完成 其 工作 后 ， 你 就 可 以 
接着 投 身 于 下 一 个 编码 任务 。 


函数 让 你 编写 代码 一 次 后 ， 想 重用 和 它们 多 少 次 就 重用 多 少 次 。 需 要 
运行 函数 中 的 代码 时 ， 只 需 编 写 一 行 函 数 调用 代码 ， 就 可 让 函数 完 
成 其 工作 。 需 要 修改 函数 的 行为 时 ， 只 需 修改 一 个 代码 块 ， 而 所 做 
的 修改 将 影响 调用 这 个 函数 的 每 个 地 方 。 


使 用 函数 让 程序 更 容易 阅读 ， 而 良好 的 函数 名 概述 了 程序 各 个 部 分 
的 作用 。 相 对 于 阅读 一 系列 的 代码 块 ， 阅 读 一 系列 函数 调用 让 你 能 
够 更 快 地 明白 程序 的 作用 。 


函数 还 让 代码 更 容易 测试 和 调试 。 如 果 程 序 使 用 一 系列 的 函数 来 完 
成 其 任务 ， 而 其 中 的 每 个 函数 都 完成 一 项 有 具体 的 工作 ， 测 试 和 维护 
起 来 将 容易 得 多 : 可 编写 分 别 调用 每 个 函数 的 程序 ， 并 测试 每 个 函 
数 是 否 在 它 可 能 过 到 的 各 种 情形 下 都 能 正确 地 运行 。 经 过 这 样 的 测 
试 后 你 束 能 充满 信心 ， 深 信 每 次 调用 这 些 函 数 时 ， 它 们 都 将 正确 地 
运行 。 


在 第 9 章 ， 你 将 学 习 编 写 类 。 类 将 函数 和 数据 整洁 地 封 效 起 来 ， 让 
你 能 够 灵活 而 高 效 地 使 用 它们 。 


~ 面向 对 象 编程 是 最 有 效 的 软件 编写 方法 之 一 。 在 
面 同 对 象 编程 中 ， 你 编写 表示 现实 世界 中 的 事物 和 情景 的 类 ， 
并 基于 这 些 类 来 创建 对 象 。 编 写 类 时 ， 你 定义 一 大 类 对 象 都 有 
的 通用 行为 。 基 于 类 创建 对 象 时 ， 每 个 对 象 都 目 动 具备 这 种 
通用 行为 ， 然 后 可 根据 需要 赋予 每 个 对 象 独特 的 个 性 。 使 用 面 
辣 对 象 编程 可 模拟 现实 情景 ， 其 晕 真 程度 达到 了 令 人 尺 讶 的 地 
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根据 类 来 创建 对 象 称 为 实例 化 ， 这 让 你 能 够 使 用 类 的 实例 。 
在 本 章 中 ， 你 将 编写 一 些 类 并 创建 其 实例 。 你 将 指定 可 在 实例 
中 存储 什么 信息 ， 定 义 可 对 这 些 实例 执行 哪些 操作 。 你 还 将 编 
写 一些 类 来 扩展 既 有 类 的 功能 ， 让 相似 的 类 能 够 高 效 地 共享 代 
码 。 你 将 把 自己 编写 的 类 存储 在 模块 中 ， 并 在 自己 的 程序 文件 
中 导入 其 他 程序 员 编 写 的 类 。 


理解 面 癌 对 象 编程 有 助 于 你 像 程 序 员 那样 看 世界 ， 还 可 以 帮助 
你 真正 明白 自己 编写 的 代码 : 不 仅 是 各 行 代码 的 作用 ， 还 有 代 
码 背 后 更 宏大 的 概念 。 了 解 类 背后 的 概念 可 培养 逻辑 思维 ， 让 
你 能 够 通过 编写 程序 来 解决 遇 到 的 几乎 任何 问题 。 


随 着 面临 的 挑战 日 益 严峻 ， 类 还 能 让 你 以 及 与 你 合作 的 其 他 程 
序 员 的 生活 更 轻松 。 如 果 你 与 其 他 程序 员 基 于 同样 的 馆 辑 来 纺 
写 代 码 ， 你 们 就 能 明白 对 方 所 做 的 工作 。 你 编写 的 程序 将 能 被 
众多 合作 者 所 理解 ， 每 个 人 都 能 事半功倍 。 


9.1 创建 和 使 用 类 


使 用 类 几乎 可 以 模拟 任何 东西 。 下 面 来 编写 一 个 表示 小 狗 的 简单 
类 Dog ， 尼 表示 的 不 是 特定 的 小 独 ， 而 是 任何 小 狗 。 对 于 大 多 数 宠 
物 狗 ， 我 们 都 知道 些 什 么 呢 ? 它们 都 有 名 字 和 和 年龄。 我 们 还 知道 ， 
大 多 数 小 狗 还 会 足下 和 打滚 。 由 于 大 多 数 小 狗 都 具备 上 述 术 两 项 信息 
名字 和 年 龄 ) 和 两 种 行为 〈 足 下 和 打滚 ) ， 我 们 的 Dog 类 将 包含 
亿 和 js 这 个 类 让 Python 知道 如 何 创建 胡 示 小 狗 的 对 象 编写 这 个 类 
后 ， 我 们 将 使 用 它 来 创建 表示 特定 小 狗 的 实例 。 


9.1.1 创建 Dog 类 


根据 Dog 类 创建 的 每 个 实例 都 将 存储 名 字 和 年 龄 ， 我 们 赋予 了 每 条 
小 狗 足下 (sit() ) 和 打 深 (roll_over() ) 的 能 力 : 


dog.py 


@ aS. Dog 


。 "一 次 模拟 小 和 的 简单 尝试 。"ws 


3 def _ init (self, name, age): 
" "初始 化 属性 name 和 age。""" 
@ self.name = name 
self.age = age 


def sit(self): 
"模拟 小 狗 收 到 命令 时 足下 。""" 


print(f"{self.name} is now sitting.") 


def roll over(self): 
" "模拟 小 狗 收 到 命令 时 打 深 。""" 
print(f"{self.name} rolled over!") 


这 里 需要 注意 的 地 方 很 多 ， 但 也 不 用 担心 ， 本 章 充 斥 着 这 样 的 结 

构 ， 你 有 大 把 的 机 会 熟悉 它 。@ 处 定义 了 一 个 名 为 Dog 的 类 。 根据 
约定 ， 在 Python 中 ， 首 字母 大 写 的 名 称 指 的 是 类 。 这 个 类 定义 中 没 
有 圆 括号 ， 因 为 要 从 空白 创建 这 个 类 。 人 处 编写 了 一 个 文档 字符 


串 ， 对 这 个 类 的 功能 做 了 描述 。 
方法 _ init__() 


类 中 的 函数 称 为 方法 。 你 在 前 面 学 到 的 有 关 函 数 的 一 切 都 适用 于 
方法 ， 束 目前 而 言 ， 唯 一 重要 的 差别 是 调用 方法 的 方式 。 全 处 的 方 
法 _init__() 是 一 个 特殊 方法 ， 每 当 你 根据 Dog 类 创建 新 实例 
时 ，Python 都 会 目 动 运行 它 。 在 这 个 方法 的 名 称 中 ， 开 头 和 末尾 各 
有 两 个 下 划 线 ， 这 是 一 种 约定 ， 旨 在 避免 Python 默认 方法 与 普通 方 
法 发 生 名 称 冲突 。 务 必 确 保 _ init__() 的 两 边 都 有 两 个 下 划 线 ， 
售 则 当 你 使 用 类 来 创建 实例 时 ， 将 不 会 目 动 调用 这 个 方法 ， 进 而 引 
发 难以 发 现 的 错误 。 


我 们 将 方法 init_() 定义 成 包含 三 个 形 参 : self 、name 和 
age 。 在 这 个 方法 的 定义 中 ， 形 参 self 必 不 可 少 ， 而 且 必 须 位 于 
其 他 形 参 的 前 面 。 为 何必 须 在 方法 定义 中 包含 形 参 self 呢 ? 因为 
Python 调用 这 个 方法 来 创建 Dog 实例 时 ， 将 自动 传 入 实 参 self 。 
个 与 实例 相关 联 的 方法 调用 都 自动 传递 实 参 self ， 它 是 一 个 指向 
实例 本 身 的 引用 ， 让 实例 能 够 访问 类 中 的 属性 和 方法 。 创 建 Dog 实 
例 时 ，Python 将 调用 Dog 类 的 方法 _ init () 。 我 们 将 通过 实 参 
向 Dog() 传递 名 字 和 年 龄 ，self 会 自动 传递 ， 因 此 不 需要 传递 
它 。 每 当 根 据 Dog 类 创建 实例 时 ， 都 只 需 给 最 后 两 个 形 参 (name 
和 age ) 提供 值 。 


他 处 定义 的 两 个 变量 都 有 前 级 self 。 以 self 为 前 级 的 变量 可 供 类 
中 的 所 有 方法 使 用 ， 可 以 通过 类 的 任何 实例 来 访问 。self.name = 
name 获取 与 形 参 name 相关 联 的 值 ， 并 将 其 赋 给 变量 name ， 然 后 
该 变量 被 关联 到 当前 创建 的 实例 。self.age = age 的 作用 与 此 类 
似 。 像 这 样 可 通过 实例 访问 的 变量 称 为 属性 。 


Dog 类 还 定义 了 另外 两 个 方法 : sit() 和 roll over() ( 见 @)， 
这 些 方 法 执行 时 不 需要 额外 的 信息 ， 因 此 它们 只 有 一 个 形 参 self 

。 我 们 随后 将 创建 的 实例 能 够 访问 这 些 方法 ， 换 句 话 说 ， 它 们 都 会 
足下 和 打滚 。 当 前 ，sit() 和 roll_over() 所 做 的 有 限 ， 只 是 打 

印 一 条 消息 ， 指 出 小 狗 正在 足下 或 打 深 。 但 可 以 扩展 这 些 方法 以 模 
拟 实 际 情况 :如果 这 个 类 包含 在 一 个 计算 机 游戏 中 ， 这 些 方 法 将 包 
含 创建 小 狗 蹲 下 和 打 深 动画 效果 的 代码 ; 如 果 这 个 类 是 用 于 控制 机 
器 狗 的 ， 这 些 方法 将 让 机 器 狗 做 出 足下 和 打滚 的 动作 。 


9.1.2 根据 类 创建 实例 


可 将 类 视 为 有 关 如 何 创建 实例 的 说 明 。Dog 类 是 一 系列 说 明 ， 让 
Python 知道 如 何 创建 表示 特定 小 狗 的 实例 。 


下 面 来 创建 一 个 表示 特定 小 狗 的 实例 : 


class Dog: 
--Snip-- 


@my dog = Dog('Willie', 6) 


@ print(f"My dog's name is {my_dog.name}.") 
©@ print(f"My dog is {my_dog.age} years old.") 


这 这 里 使 用 的 是 前 一 个 示例 中 编写 的 Dog 类 。 在 @ 处 ， 让 Python 创 
建 一 条 名 字 为 "Willie" 、 年 龄 为 6 的 小 狗 。 遇 到 这 行 代 码 时 ， 
Python 使 用 实 参 'Willie' 和 6 调用 Dog 类 的 方法 _init ()。 方 
法 _init _() 创建 一 个 表示 特定 小 狗 的 实例 ， 并 使 用 提供 的 值 来 
设置 属性 name 和 age 。 接 下 来 ，Python 返 回 一 个 表示 这 条 小 狗 的 实 
例 ， 而 我 们 将 这 个 实例 赋 给 了 变量 my_dog 。 在 这 里 ， 命 名 约定 很 
有 用 : 通常 可 认为 首 字母 大 写 的 名 称 〈( 如 Dog ) 指 的 是 类 ， 而 小 写 
的 名 称 〈 如 my_dog ) 指 的 是 根据 类 创建 的 实例 。 


a. 访问 属性 


要 访问 实例 的 属性 ， 可 使 用 句点 表示 法 。 全 处 编写 了 如 下 代码 
来 访问 my_dog 的 属性 name 的 值 : 


句点 表示 法 在 Python 中 很 常用 ， 这 种 语法 演示 了 Python 如 何 获 
悉 属 性 的 值 。 在 这 里 ， Python 先 找到 实例 my_dog ， 再 查找 与 
该 实例 相关 联 的 属性 name 。 在 Dog 类 中 引用 这 个 属性 时 ， 使 
。 在 人 处， 使 用 同样 的 方法 来 获取 属性 age 


输出 是 有 关 my_dosg 的 摘要 : 


My dog's name is Willie. 
My dog is 6 years old. 


. 调用 方法 


根据 Dog 类 创建 实例 后 ， 束 能 使 用 句点 表示 法 来 调用 Dog 类 中 
定义 的 任何 方法 了 了。 下 面 来 让 小 狗 足 下 和 打滚 : 


class Dog: 
--Snip-- 


my _ dog = Dog('Willie', 6) 
my_dog.sit() 
my_dog.roll over() 


要 调用 方法 ， 可 指定 实例 的 名 称 ( 这 里 是 my_dog ) 和 要 调用 
的 方法 ， 并 用 句点 分 隔 。 遇 到 代码 my_dog.sit() 时 ，Python 
在 类 Dog 中 查找 方法 sit() 并 运行 其 代码 。Python 以 同样 的 方 
式 解 读 代 码 my_dog.roll_over() 。 


Willie 按 我 们 的 命令 做 了 : 


Willie is now sitting. 
Willie rolled over! 


这 种 语法 很 有 用 。 如 果 给 属性 和 方法 指定 了 合适 的 描述 性 名 
称 ， 如 name 、age 、sit() 和 roll_over()， 即 便 是 从 未 见 
过 的 代码 块 ， 我 们 也 能 够 轻松 地 推 新 出 它 是 做 什么 的 。 


c 创建 多 个 实例 


可 按 需 求 根据 类 创建 任意 数量 的 实例 。 下 面 再 创建 一 个 名 
为 your_dog 的 小 狗 实例 : 


class Dog: 
--Snip-- 


my _ dog = Dog('Willie', 6) 
your _ dog = Dog('Lucy', 3) 


print(f"My dog's name is {my_dog.name}.") 


print(f"My dog is {my dog.age} years old.") 
my_dog.sit() 


print(f"\nYour dog's name is {your dog.name}.") 
print(f"Your dog is {your dog.age} years old.") 
your_dog.sit() 


在 本 例 中 创建 了 两 条 小 狗 ， 分 别名 为 Willie 和 Lucy。 每 条 小 狗 
ee 有 自己 的 一 组 属性 ， 能 够 执行 相同 的 操 


My dog's name is Willie. 
My dog is 6 years old. 
Willie is now sitting. 


Your dog's name is Lucy. 
Your dog is 3 years old. 
Lucy is now sitting. 


即使 给 第 二 条 小 狗 指定 同样 的 名 字 和 年 龄 ，Python 依 然 会 根 
气 Dog 类 创建 妃 一 个 实例 。 你 可 按 需 求 根据 一 个 类 创建 任意 数 
量 的 实例 ， 条 件 是 将 每 个 实例 都 存储 在 不 同 的 变量 中 ， 或 者 占 
用 列表 或 字典 的 不 同位 置 。 


动手 试 一 斌 


练习 9-1: 餐馆 ”创建 一 个 名 为 Restaurant 的 类 ， 为 其 方法 
_init () 设置 属性 restaurant_name 和 cuisine _ type 。 
创建 一 个 名 为 describe_restaurant() 的 方法 和 一 个 名 

为 open_restaurant() 的 方法 ， 前 者 打印 前 述 两 项 信息 ， 而 
后 者 打印 一 条 消息 ， 指 出 餐馆 正在 营业 。 


根据 这 个 类 创建 一 个 名 为 restaurant 的 实例 ， 分 别 打 印 其 两 
个 属性 ， 再 调用 前 述 两 个 方法 。 


练习 9-2: 三 家 餐馆 ”根据 为 完成 练习 9-1 而 编写 的 类 创建 三 个 
实例 ， 并 对 每 个 实例 调用 方法 describe_restaurant() 。 


练习 9-3: 用 户 ”创建 一 个 名 为 User 的 类 ， 其 中 包含 属 

性 first_name 和 last_name ， 以 及 用 户 简介 通常 会 存储 的 其 
他 几 个 属性 。 在 类 User 中 定义 一 个 名 为 describe_user() 的 
方法 ， 用 于 打印 用 户 信息 摘要 。 再 定义 一 个 名 

为 greet_user() 的 方法 ， 用 于 同 用 户 发 出 个 性 化 的 问候 。 


0 并 对 每 个 实例 调用 上 述 两 个 方 
这 


9.2 ”使 用 类 和 实例 


可 使 用 类 来 模拟 现实 世界 中 的 很 多 情景 。 类 编写 好 后 ， 你 的 大 部 分 
时 间 将 花 在 根据 类 创建 的 实例 上 。 你 需要 执行 的 一 个 重要 任务 是 修 
改 实例 的 属性 。 可 以 直接 修改 实例 的 属性 ， 也 可 以 编写 方法 以 特定 
的 方式 进行 修改 。 


9.2.1 Car 类 


下 面 来 编写 一 个 表示 汽车 的 类 。 它 存储 了 有 关 汽 车 的 信息 ， 还 有 一 
个 汇总 这 些 信 县 的 方 法 : 


car.py 


class Car: 


"" 一 次 模拟 汽车 的 简单 尝试 。""" 


def lt Sots make, mode1， year) : 
"初始 化 描述 汽车 的 属性 
self.make = make 
self.model = model 
self.year = year 


def get descriptive name(self): 
"" 返 回 整 洁 的 描述 性 信息 。""" 
long name = f"{self.year} {self.make} {self.model}" 
return long name.title() 
Be my_new car = Car('audi', 'a4', 20819) 
print(my_new_ car.get descriptive name()) 


在 @ 处 ， 定 义 了 方法 _init () 。 与 前 面 的 Dog 类 中 一 样 ， 这 个 
方法 的 第 一 个 形 参 为 self 。 该 方法 还 包含 另外 三 个 形 参 : make 
、model 和 year 。 方法 _init _() 接受 这 些 形 参 的 值 ， 并 将 它们 
赋 给 根据 这 个 类 创建 的 实例 的 属性 。 创 建新 的 Car 实例 时 ， 需 要 指 
定 其 制造 商 、 型 号 和 生产 年 份 。 


在 四 处 ， 定 义 了 一 个 名 为 get_descriptive_name() 的 方法 。 它 


使 用 属性 year 、make 和 model 创建 一 个 对 汽车 进行 描述 的 字符 
串 ， 让 我 们 无 须 分 别 打 印 每 个 属性 的 值 。 为 在 这 个 方法 中 访问 属性 
的 值 ， 使 用 了 self.make 、self.model 和 self.year 。 在 全 处 ， 
根据 Car 类 创建 了 一 个 实例 ， 并 将 其 赋 给 变量 my_new_car 。 接 下 
来 ， 调 用 方法 get_descriptive_name() ， 指 出 我 们 拥有 一 辆 什 
么 样 的 汽车 : 


2619 Audi A4 


为 了 让 这 个 类 更 有 趣 ， 下 面 给 它 添加 一 个 随时 间 变 化 的 属性 ， 用 于 
存储 汽车 的 总 里 程 。 


9.2.2 ”给 属性 指定 默认 值 


创建 实例 时 ， 有 些 属 性 无 顷 通 过 形 参 来 定义 ， 可 在 方法 
_ init_() 中 为 其 指定 默认 值 。 


下 面 来 添加 一 个 名 为 odometer_reading 的 属性 ， 其 初始 值 总 是 为 
0。 我 们 还 添加 了 一 个 名 为 read_odometer() 的 方法 ， 用 于 读 取 汽 
车 的 里 程 表 : 


class Car: 


def nit (Self make, model, year) : 
"初始 化 描述 汽车 的 属性 
self.make = make 
self.model = model 
self.year = year 
© self.odometer reading = 6 


def get descriptive name(self): 
--Snip-- 
@ def read odometer(self): 
"" 打 印 一 条 指出 汽车 里 程 的 消息 。""" 


print(f"This car has {self.odometer reading} miles on it.") 


my_new_car = Car('audi', 'a4', 206019) 
print(my_new car.get descriptive name()) 
my_new_car.read odometer() 


| | 


现在 ， 当 Python 调 用 方法 _init _() 来 创建 新 实例 时 ， 将 像 前 一 
个 示例 一 样 以 属性 的 方式 存储 制造 商 、 型 号 和 生产 年 份 。 接 下 来 ， 
Python 将 创建 一 个 名 为 odometer_reading 的 属性 ， 并 将 其 初始 值 
设置 为 0( 见 @)。 在 介 @ 处 ， 定 义 一 个 名 为 read_odometer() 的 方 
法 ， 让 你 能 够 轻松 地 获悉 汽车 的 里 程 1 。 


1 此 处 里 程 的 单位 为 英里 (mile) ，1 英 里 s 1.6 千 米 。 一 ”编者 注 


一 开始 汽车 的 里 程 为 0: 


2019 Audi A4 
This car has 6 miles on it. 


i at 因此 需要 一 种 方式 来 修改 该 属 


9.2.3 ”修改 属性 的 值 

我 们 能 以 三 种 方式 修改 属性 的 值 : 直接 通过 实例 进行 修改 ， 通 过 方 
法 进行 设置 ， 以 及 通过 方法 进行 递增 (增加 特定 的 值 ) 。 下 面 依 次 
介绍 这 些 方式 。 

a， 直 接 修 改 属性 的 值 


要 修改 属性 的 值 ， 最 简单 的 方式 是 通过 实例 直接 访问 它 。 下 面 
的 代码 直接 将 里 程 表 读数 设置 为 23: 


class Car: 
--Snip-- 


my_new_car = Car('audi', 'a4', 206019) 
print(my_new car.get descriptive name()) 


@ my_new car.odometer reading = 23 
my_new_car.read odometer() 


[L 


在 @ 处 ， 使 用 句点 表示 法 直接 访问 并 设置 汽车 的 属 

性 odometer_reading 。 这 行 代码 让 Python 在 实例 
my_new_car 中 找到 属性 odometer_reading ， 并 将 其 值 设置 
为 23: 


2019 Audi A4 
This car has 23 miles on it. 


有 时 候 需 要 像 这 样 直 接 访问 属性 ， 但 其 他 时 候 需 要 编写 对 属性 
进行 更 新 的 方法 。 


通过 方法 修改 属性 的 值 


如 果 有 方法 能 亚 你 更 新 属性 ， 将 大 有 人 神 益 。 这 样 就 无 须 直 接 访 
问 属 性 ， 而 可 将 值 传递 给 方法 ， 由 它 在 内 部 进行 更 新 。 


下 面 的 示例 演示 了 一 个 名 为 update_odometer() 的 方法 : 


class Car: 
--Snip-- 


def update_ odometer(self, mileage); 
'" 将 里 程 表 读数 设置 为 指定 的 值 。' 


self.odometer reading = mileage 


my_new_car = Car('audi', 'a4', 206019) 
print(my_new car.get descriptive name()) 


@ my_new car.update odometer(23) 
my_new_car.read odometer() 


对 Car 类 所 做 的 唯一 修改 是 在 @ 处 添加 了 方法 
update_odometer() 。 这 个 方法 接受 一 个 里 程 值 ， 并 将 其 赋 
给 self.odometer_reading 。 在 全 处 ， 调 


用 update_odometer() ， 并 向 它 提 供 了 实 参 23 〈 该 实 参 对 应 
于 方法 定义 中 的 形 参 mileage ) 。 它 将 里 程 表 读 数 设 置 为 23， 
而 方法 read_odometer() 打印 该 读数 : 


2019 Audi A4 
This car has 23 miles on it. 


可 对 方法 update_odometer() 进行 扩展 ， 使 其 在 修改 里 程 表 
读数 时 做 些 额外 的 工作 。 下 面 来 添加 一 些 馆 辑 ， 茶 止 任 何人 将 
里 程 表 读数 往 回调 : 
class Car: 
--Snip-- 


def update_odometer(self, mileage): 


将 里 程 表 读数 设置 为 指定 的 值 。 
禁止 将 里 程 表 读数 往 回 调 。 


if mileage >= self.odometer reading: 
self.odometer reading = mileage 

else: 
print("You can't roll back an odometer!") 


现在 ，update_odometer() 在 修改 属性 前 检查 指定 的 读数 是 
否 合 理 。 如 果 新 指定 的 里 程 (mileage ) 大 于 或 等 于 原来 的 里 
程 (self.odometer _reading ) ， ， 就 将 里 程 表 读 数 改 为 新 指 
oe ( 见 @) ; 否则 发 出 警告 ， 指 出 不 能 将 里 程 表 往 回调 
( 几 @) 。 


通过 方法 对 属性 的 值 进行 递增 


有 时 候 需 要 将 属性 值 递 增 特定 的 量 ， 而 不 是 将 其 设置 为 全 新 的 
值 。 假 设 我 们 购买 了 一 辆 二 手 车 ， 且 从 购买 到 登记 期 间 增加 了 
100 英 里 的 里 程 。 下 面 的 方法 让 我 们 能 够 传递 这 个 增 量 ， 并 相 
应 地 增 大 里 程 表 读 数 : 


class Car: 
--Snip-- 


def update odometer(self, mileage): 
--Snip-- 


def increment odometer(self, miles): 
"" 将 里 程 表 读数 增加 指定 的 量 。 


self.odometer reading += miles 


my_used car = Car('subaru', 'outback', 20815) 
print(my_used car.get descriptive name()) 


my_used_ car.update odometer(23 566) 
my_used_ car.read odometer() 


my_used _ car.increment _ odometer(1060) 
my_used_ car.read odometer() 


在 @ 处 ， 新 增 的 方法 increment_odometer() 接受 一 个 单位 
为 英里 的 数 ， 并 将 其 加 入 self.odometer_reading 中 。 在 @ 
处 ， 创 建 一 辆 二 手 车 my_used_car 。 在 全 处 ， 调 用 方法 
update_odometer() 并 传 入 23_566 ， 将 这 辆 二 手 车 的 里 程 表 
读数 设置 为 23 500。 在 @@ 处 ， 调 用 increment_odometer() 并 
传 入 168 ， 以 增加 从 购买 到 登记 期 间 行驶 的 100 英 里 : 


2615 Subaru Outback 
This car has 23566 miles on it. 


This car has 23666 miles on it. 


你 可 以 轻松 地 修改 这 个 方法 ， 以 禁止 增 量 为 负 值 ， 从 而 防止 有 
人 利用 它 来 回调 里 程 表 。 


注意 ”你 可 以 使 用 类 似 于 上 面 的 方法 来 控制 用 户 修改 属 
性 值 《 如 里 程 表 读 数 ) 的 方式 ， 但 能 够 访问 程序 的 人 都 可 
以 通过 直接 访问 属性 来 将 里 程 表 修 改 为 任何 值 。 要 确保 安 
二 除了 进行 类 似 于 前 面 的 基本 检查 外 ， 还 需 特 别 注 意 细 
3 


动手 试 一 斌 


练习 9-4: 就 餐 人 数 ”在 为 完成 练习 9-1 而 编写 的 程序 中 ， 添 加 
一 个 名 为 number_served 的 属性 ， 并 将 其 默认 值 设 置 为 0。 根 
据 这 个 类 创建 一 个 名 为 restaurant 的 实例 。 打 印 有 多 少 人 在 
这 家 和 餐馆 就 餐 过 ， 然 后 修改 这 个 值 并 再 次 打印 它 。 


添加 一 个 名 为 set_number_served() 的 方法 ， 让 你 能 够 设置 
rt 调用 这 个 方法 并 问 它 传递 一 个 值 ， 然 后 再 次 打印 这 
| 


添加 一 个 名 为 increment_number_served() 的 方法 ， 让 你 能 
够 将 就 餐 人 数 递增 。 调 用 这 个 方法 并 疝 它 传递 一 个 这 样 的 值 : 
你 认为 这 家 餐馆 每 天 可 能 接待 的 就 餐 人 数 。 


练习 9-5: 尝试 登录 次 数 ”在 为 完成 练习 9-3 而 编写 的 User 类 
中 ， 添 加 一 个 名 为 login_attempts 的 属性 。 编 写 一 个 名 
为 increment_login attempts() 的 方法 ， 将 属 

性 login_attempts 的 值 加 1。 再 编写 一 个 名 

为 reset_login_attempts() 的 方法 ， 将 属 

性 login_attempts 的 值 重 置 为 0。 


根据 User 类 创建 一 个 实例 ， 再 调用 方法 

increment login_attempts() 多 次 。 打 印 局 

性 login_attempts 的 值 ， 确 认 它 被 正确 地 递增 。 然 后 ， 调 用 
方法 reset_login attempts() ， 并 再 次 打印 属 

性 login_attempts 的 值 ， 确 认 它 被 重 置 为 0。 


9.3 ”继承 


编写 类 时 ， 并 非 总 是 要 从 空白 开始 。 如 果 要 编写 的 类 是 力 一 个 现成 
类 的 特殊 版 本 ， 可 使 用 继承 。 一 个 类 继承 另 一 个 类 时 ， 将 上 自动 获 
得 吃 一 个 类 的 所 有 属性 和 方法 。 原 有 的 类 称 为 父 类 ， 而 新 类 称 为 

子 类 。 子 类 继承 了 父 类 的 所 有 属性 和 方法 ， 同 时 还 可 以 定义 自己 

的 属性 和 方法 。 


9.3.1 子 类 的 方法 _ init _ () 

在 既 有 类 的 基础 上 编写 新 类 时 ， 通 种 要 调用 父 类 的 方法 

_ init () 。 这 将 初始 化 在 父 类 ”init _() 方法 中 定义 的 所 有 
属性 ， 从 而 让 子 类 包含 这 些 属性 。 

例如 ， 下 面 来 模拟 电动 汽车 。 电 动 汽 车 是 一 种 特殊 的 汽车 ， 因 此 可 
在 前 面 创建 的 Car 类 的 基础 上 创建 新 类 ElectricCar 。 这 样 就 只 需 
为 电动 汽车 特有 的 属性 和 行为 编写 代码 。 


下 面 来 创建 ElectricCar 类 的 一 个 简单 版 本 ， 它 具备 Car 类 的 所 有 


electric_car.py 


@ class Car: 


""" 一 次 模拟 汽车 的 简单 尝试 。""" 


def _ init (self, make, model, year): 
self.make = make 
self.model = model 
self.year = year 
self.odometer reading = 6 


def get descriptive name(self): 
long name = f"{self.year} {self.make} {self.model}" 
return long name.title() 


def read odometer(self): 
print(f"This car has {self.odometer reading} miles on it.") 


def update odometer(self, mileage): 
if mileage >= self.odometer reading: 
self.odometer reading = mileage 
else: 
print("You can't roll back an odometer!") 


def increment odometer(self, miles): 
self.odometer reading += miles 


@ class ElectricCar(Car): 


“"" 电 动 汽车 的 独特 之 处 。""" 

3 def _ init (self, make, model, year): 
"" "初始化 父 类 的 属性 。""" 

@ super(). init (make, model, year) 


© my_tesla = ElectricCar('tesla', 'model s', 20819) 
print(my_ tesla.get descriptive name()) 


首先 是 Car 类 的 代码 ( 见 @)〉。 创 建 子 类 时 ， 父 类 必须 包含 在 当前 
文件 中 ， 且 位 于 子 类 前 面 。 在 全 处 ， 定 义 了 子 类 ElectricCar 。 
定义 子 类 时 ， 必 须 在 圆 括号 内 指定 父 类 的 名 称 。 方 法 __init__() 


接受 创建 Car 实例 所 需 的 信息 〈 见 全 ) 。 


四 处 的 super() 是 一 个 特殊 函数 ， 让 你 能 够 调用 父 类 的 方法 。 这 行 
代码 让 Python 调用 Car 类 的 方法 _ init () ， 让 ElectricCar 实 
例 包 含 这 个 方法 中 定义 的 所 有 属性 。 父 类 也 称 为 超 类 

Csuperclass) ， 名 称 super 由 此 而 来 。 


为 测试 继承 能 够 正确 地 发 挥 作用 ， 我 们 尝试 创建 一 辆 电动 汽车 ， 但 
提供 的 信息 与 创建 普通 汽车 时 相同 。 在 加 处 ， 创 建 ElectricCar 
类 的 一 个 实例 ， 并 将 其 赋 给 变量 my_tesla 。 这 行 代码 调 

用 ElectricCar 类 中 定义 的 方法 _init () ， 后 者 让 Python 调用 
父 类 Car 中 定义 的 方法 _init () 。 我 们 提供 了 实 参 'tesla' 
、'model s' 和 2619 。 


除 方法 _init___() 外 ， 电 动 汽车 没有 其 他 特有 的 属性 和 方法 。 
当前 ， 我 们 只 想 确 认 电 动 汽车 具备 普通 汽车 的 行为 : 


2019 Tesla Model S 


ElectricCar 实例 的 行为 与 Car 实例 一 样 ， 现 在 可 以 开始 定义 电动 
汽车 特有 的 属性 和 方法 了 。 

9.3.2 ”给 子 类 定义 属性 和 方法 

让 一 个 类 继承 另 一 个 类 后 ， 就 可 以 添加 区 分 子 类 和 父 类 所 需 的 新 属 
性 和 新 方法 了 。 


下 面 来 添加 一 个 电动 汽车 特有 的 属性 《电瓶 ) ， 以 及 一 个 描述 该 属 
我 们 将 存储 电瓶 容量 ， 并 编写 一 个 打印 电瓶 描述 的 方 
法 : 


class Car: 
--Snip-- 


class ElectricCar(Car): 


"" 电 动 汽车 的 独特 之 处 。""" 


def nt __ (self, make, model, year): 


初 给 化 父 类 的 属性 。 
再 初始 化 电动 汽车 特有 的 属性 。 


super(). init (make, model, year) 
self.battery size = 75 


def describe battery(self): 
"" 打 印 一 条 描述 电瓶 容量 的 消息 。""" 
print(f"This car has a {self.battery size}-kWh battery.") 


my_tesla = ElectricCar('tesla', 'model s', 2019) 
print(my_ tesla.get descriptive name()) 
my_tesla.describe battery() 


在 @ 处 ,添加 了 新 属性 self.battery_size ， 并 设置 其 初始 值 
(75 ) 。 根 据 ElectricCar 类 创建 的 所 有 实例 都 将 包含 该 属性 ， 
但 所 有 Car 实例 都 不 包含 它 。 在 全 处 ， 还 添加 了 一 个 名 


为 describe_battery() 的 方法 ， 打 印 有 关 电 瓶 的 信息 。 调 用 这 个 
方法 时 ， 将 看 到 一 条 电动 汽车 特有 的 描述 : 


2619 Tesla Model S 
This car has a 75-kWh battery. 


对 于 ElectricCar 类 的 特殊 程度 没有 任何 限制 。 模 拟 电动 汽车 
时 ， 可 根据 所 需 的 准确 程度 添加 任意 数量 的 属性 和 方法 。 如 果 一 个 
属性 或 方法 是 任何 汽车 都 有 的 ， 而 不 是 电动 汽车 特有 的 ， 就 应 将 其 
加 入 到 Car 类 而 非 ElectricCar 类 中 。 这 样 ， 使 用 Car 类 的 人 将 获 
得 相应 的 功能 ， 而 ElectricCar 类 只 包含 处 理 电动 汽车 特有 属性 
和 行为 的 代码 。 


9.3.3 重 写 父 类 的 方法 


对 于 父 类 的 方法 ， 只 要 它 不 符合 子 类 模拟 的 实物 的 行为 ， 都 可 以 进 
行 重 写 。 为 此 ， 可 在 子 类 中 定义 一 个 与 要 重 写 的 父 类 方法 同名 的 方 
法 。 这 样 ，Python 将 不 会 考虑 这 个 父 类 方法 ， 而 只 关注 你 在 子 类 中 
定义 的 相应 方法 。 


假设 car 类 有 一 个 名 为 fil1_gas _ tank() 的 方法 ， 它 对 全 电动 汽 
车 来 说 坚 无 意义 ， 因此 你 可 能 想 重 写 它 。 下 面 演示 了 一 种 重 写 方 


式 : 


class ElectricCar(Car): 
--Snip-- 


def fill] gas tank(self): 


电动 汽车 没有 油箱 。""" 
print("This car doesn't need a gas tank!") 


现在 ， 如 果 有 人 对 电动 汽车 调用 方法 fil1_gas_tank() ，Python 
将 忽略 Car 类 中 的 方法 fi1l1_gas tank() ， 转 而 运行 上 述 代码 。 
使 用 继承 时 ， 可 让 子 类 保留 从 父 类 那里 继承 而 来 的 精华 ， 并 剔除 不 


需要 的 糟粕 。 


9.3.4 将 实例 用 作 属 性 


使 用 代码 模拟 实物 时 ， 你 可 能 会 及 现 目 己 给 类 添加 的 细节 越 来 越 
多 : 属性 和 方法 清单 以 及 文件 都 越 来 越 长 。 在 这 种 情况 下 ， 可 能 需 
要 将 类 的 一 部 分 提取 出 来 ， 作 为 一 个 独立 的 类 。 可 以 将 大 型 类 拆 分 
成 多 个 协同 工作 的 小 类 。 


例如 ， 不 断 给 ElectricCar 类 添加 细 市 时 ， 我 们 可 能 发 现 其 中 包 
含 很 多 专门 针对 汽车 电瓶 的 属性 和 方法 。 在 这 种 情况 下 ， 可 将 这 些 
属性 和 方法 提取 出 来 ， 放 到 一 个 名 为 Battery 的 类 中 ， 并 将 一 

个 Battery 实例 作为 ElectricCar 类 的 属性 : 


class Car: 
--Snip-- 


@ class Battery : 


次 模拟 电动 汽车 电瓶 的 简单 尝试 。""" 


def nit __ (self, battery_ size=75): 
"初始 化 电瓶 的 属性 。 


self.battery size = battery _ size 


def describe battery(self): 
"" 打 印 一 条 描述 电瓶 容量 的 消息 。""" 
print(f"This car has a {self.battery size}-kWh battery.") 


class ElectricCar(Car): 


"电动 汽车 的 独特 之 处 。""" 


def nit Sel make, model, year): 


初始 化 父 类 的 属性 。 
再 初始 化 电动 汽车 特有 的 属性 。 


super(). init (make, model, year) 
self.battery = Battery() 


my_tesla = ElectricCar('tesla', 'model s', 2019) 


print(my_ tesla.get descriptive name()) 
my_tesla.battery.describe battery() 


QO 处 定义 一 个 名 为 Battery 的 新 类 ， 它 没有 继承 任何 类 。 人 处 的 方 
法 _ init__() 除 self 外 ， 还 有 男 一 个 形 参 battery_size 。 这 个 
形 参 是 可 选 的 : 如 果 没 有 给 它 提供 值 ， 电 瓶 容 量 将 被 设置 为 75。 方 
法 describe_battery() 也 移 到 了 这 个 类 中 ( 见 @) 。 


在 ElectricCar 类 中 ， 添 加 了 一 个 名 为 self.battery 的 属性 《〈 见 
四 ) .这 行 代 码 让 Python 创建 一 个 新 的 Battery 实例 (因为 没有 指 
定 容量 ， 所 以 为 默认 值 75) ， 并 将 该 实例 赋 给 属性 self.battery 

。 每 当 方 法 _ init _() 被 调用 时 ， 都 将 执行 该 操作 ， 因 此 现在 每 

个 ElectricCar 实例 都 包含 一 个 自动 创建 的 Battery 实例 。 


我 们 创建 一 辆 电动 汽车 ， 并 将 其 赋 给 变量 my_tes1la 。 描 述 电 瓶 
时 ， 需 要 使 用 电动 汽车 的 属性 battery : 


my_tesla.battery.describe battery() 


这 行 代码 让 Python 在 实例 my_tes1a 中 查找 属性 battery ， 并 对 存 
储 在 该 属性 中 的 Battery 实例 调用 方法 describe_battery() 。 


输出 与 你 在 前 面 看 到 的 相同 : 


2619 Tesla Model S 
This car has a 75-kWh battery. 


这 看 似 做 了 很 多 额外 的 工作 ， 但 是 现在 想 多 详细 地 描述 电瓶 都 可 
以 ， 且 不 会 导致 ElectricCar 类 混乱 不 堪 。 下 面 再 给 Battery 类 
添加 一 个 方法 ， 它 根据 电瓶 容量 报告 汽车 的 续航 里 程 : 


class Car: 
--Snip-- 


class Battery : 
--Snip-- 


@ def get_range(self) : 
”"" 打 印 一 条 消息 ， 指 出 电瓶 的 续航 里 程 。""" 


if self.battery size == 75 : 


range = 260 
elif self.battery_ size == 10608: 
range = 315 


print(f"This car can go about {range} miles on a full charge 


class ElectricCar(Car): 
--Snip-- 


my_tesla = ElectricCar('tesla', 'model s' ，2619) 
print(my_ tesla.get_descriptive_name()) 
my_tesla.battery.describe battery() 

@ my_tesla.battery.get range() 


@@ 处 新 增 的 方法 get_range() 做 了 一 些 简单 的 分 析 : 如 果 电 瓶 的 
容量 为 75 kWh， 就 将 续航 里 程 设置 为 260 英 里 ;如 果 容 量 为 100 
kWh， 就 将 续航 里 程 设置 为 315 英 里 ， 然 后 报告 这 个 值 。 为 使 用 这 
个 方法 ， 也 需要 通过 汽车 的 属性 battery 来 调用 ( 见 @) 。 


输出 指出 了 汽车 的 续航 里 程 ( 这 取决 于 电瓶 的 容量 )〉: 


2619 Tesla Model S 
This car has a 75-kWh battery. 


This car can go about 266 miles on a full charge. 


9.3.5 ”模拟 实物 


模拟 较 复 杂 的 物件 (如 电动 汽车 ) 时 ， 需 要 解决 一 些 有 趣 的 问题 。 
续航 里 程 是 电瓶 的 属性 还 是 汽车 的 属性 昵 ? 如 果 只 描述 一 辆 汽车 ， 

将 方法 get_range() 放 在 Battery 类 中 也 许 是 合适 的 ， 但 如 果 要 

描述 一 家 汽车 制造 商 的 整个 产品 线 ， 也 许 应 该 将 方法 get_range() 
移 到 ElectricCar 类 中 。 在 这 种 情况 下 ，get_range() 依然 根据 
电瓶 容量 来 确定 续航 里 程 ， 但 报告 的 是 一 款 汽 车 的 续航 里 程 。 也 可 
以 这 样 做 : 仍 将 方法 get_range() 留 在 Battery 类 中 ， 但 向 它 传 

递 一 个 参数 ， 如 car_model 。 在 这 种 情况 下 ， 方 法 get_range() 

将 根据 电瓶 容量 和 汽车 型 号 报告 续航 里 程 。 


这 让 你 进入 了 程序 员 的 另 一 个 境界 :解决 上 述 问题 时 ， 从 较 高 的 多 
各 层面 〈 而 不 是 语法 层面 ) 考虑 ;考虑 的 不 是 Python， 而 是 如 何 使 
用 代码 来 表示 实物 。 达 到 这 种 境界 后 ， 你 会 经 党 发现 ， 对 现实 世界 
的 建 模 方法 没有 对 错 之 分 。 有 些 方法 的 效率 更 高 ， 但 要 找 出 效率 最 
高 的 表示 法 ， 需 要 经 过 一 定 的 实践 。 只 要 代码 像 你 希望 的 那样 运 

行 ， 就 说 明 你 做 得 很 好 ! 即便 发 现 自己 不 得 不 多 次 尝试 使 用 不 同 的 
方法 来 重 写 类 ， 也 不 必 气 馆 。 要 编写 出 高 效 、 准 确 的 代码 ， 都 得 经 
过 这 样 的 过 程 。 


动手 试 一 斌 


练习 9-6: 冰激凌 小 店 ”冰激凌 小 店 是 一 种 特殊 的 餐馆 。 编 写 
一 个 名 为 IceCreamStand 的 类 ， 让 它 继 承 为 完成 练习 9-1 或 练 
习 9-4 而 编写 的 Restaurant 类 。 这 两 个 版 本 的 Restaurant 类 
都 可 以 ， 挑 选 你 更 喜欢 的 那个 即 可 。 添 加 一 个 名 为 flavors 的 
属性 ， 用 于 存储 一 个 由 各 种 口味 的 冰激凌 组 成 的 列表 。 编 写 一 
个 显示 这 些 冰 激 凌 的 方法 。 创 建 一 个 IceCreamStand 实例 ， 
并 调用 这 个 方法 。 


练习 9-7: 管理 员 ”管理 员 是 一 种 特殊 的 用 户 。 编 写 一 个 名 
为 Admin 的 类 ， 让 它 继承 为 完成 练习 9-3 或 练习 9-5 而 编写 的 
User 类 。 添 加 一 个 名 为 privileges 的 属性 ， 用 于 存储 一 个 由 
字符 串 (如 "can add post" 、"can delete post" 、"can 
ban user" 等 ) 组 成 的 列表 。 编 写 一 个 名 

为 show_privileges() 的 方法 ， 显 示 管 理 员 的 权限 。 创 建 一 
个 Admin 实例 ， 并 调用 这 个 方法 。 


练习 9-8: 权限 ”编写 一 个 名 为 Privileges 的 类 ， 它 只 有 一 
个 属性 privileges ， 其 中 存储 了 练习 9-7 所 述 的 字符 串 列 表 。 
将 方法 show_privileges() 移 到 这 个 类 中 。 在 Admin 类 中 ， 

将 一 个 Privileges 实例 用 作 其 属性 。 创 建 一 个 Admin 实例 ， 

并 使 用 方法 show_privileges() 来 显示 其 权限 。 


练习 9-9: 电瓶 升级 ”在 本 节 最 后 一 个 electric_car.py 版 本 中 ， 
给 Battery 类 添加 一 个 名 为 upgrade_battery() 的 方法 。 该 
方法 检查 电瓶 容量 ， 如 果 不 是 100， 就 将 其 设置 为 100。 创 建 一 
辆 电瓶 容量 为 默认 值 的 电动 汽车 ， 调 用 方法 get_range() ， 
然后 对 电瓶 进行 升级 ， 并 再 次 调用 get_range() 。 你 将 看 到 


这 辆 汽车 的 续航 里 程 增加 了 。 


9.4 导入 类 


随 着 不 断 给 类 添加 功能 ， 文 件 可 能 变 得 很 长 ， 即 便 妥 善 地 使 用 了 继 
承 亦 如 此 。 为 遵循 Python 的 总 体 理念 ， 应 让 文件 尽 可 能 整洁 。 
Python 在 这 方面 提供 了 帮助 ， 人 允许 将 类 存储 在 模块 中 ， 然 后 在 主 程 
序 中 导入 所 需 的 模块 。 


9.4.1 导入 单个 类 


下 面 来 创建 一 个 只 包含 car 类 的 模块 。 这 让 我 们 面临 一 个 微妙 的 命 
名 问题 : > Me 个 名 为 car.py 的 文件 ， 但 这 个 模块 也 应 
命名 为 car.py， 因 为 它 包 含 表示 汽车 的 代码 。 我 们 将 这 样 解决 这 个 
命名 问题 : 将 Car 类 存储 在 一 个 名 为 car.py 的 模块 中 ， 该 模块 将 履 
善 前 面 使 用 的 文件 car.py。 从 现在 开始 ， 使 用 该 模块 的 程序 都 必须 
使 用 更 具体 的 文件 名 ， 如 my_car.py。 下 面 是 模块 car.py， 其 中 只 包 
含 Car 类 的 代码 : 


car.py 


e@""" 一 个 可 用 于 表示 汽车 的 类 。""" 


class Car: 


mn 一 次 模拟 汽车 的 简单 尝试 。 nnn 


def _ init (self, make, model, year): 
"初始 化 描述 汽车 的 属性 。""" 
self.make = make 
self.model = model 
self.year = year 
self.odometer reading = 6 


def get descriptive name(self): 
"返回 整洁 的 描述 性 名 称 。""" 
long name = f"{self.year} {self.make} {self.model}" 
return long name.title() 


def read _odometer(self) : 
“打印 一 条 消息 ， 指 出 汽车 的 里 程 。""" 


print(f"This car has {self.odometer reading} miles on it.") 


def update_odometer(self, mileage): 


将 里 程 表 读数 设置 为 指定 的 值 。 
拒绝 将 里程 表 往 回 调 。 


if mileage >= self.odometer reading: 
self.odometer reading = mileage 

else: 
print("You can't roll back an odometer!") 


def inerement _odometer(self, miles): 
"" 将 里 程 表 读 数 增加 指定 的 量 。' 


self.odometer reading += miles 


0 ， 对 该 模块 的 内 容 做 了 简要 的 描 
。 你 应 为 目 己 创 建 的 每 个 模块 编写 文档 字符 串 。 


店面 米 创建 另 一 个 文件 my_carpy， 在 其 中 导入 Car 类 并 创建 其 实 
列 : 


my_car.py 


@ from car import Car 


my_new_car = Car('audi', 'a4', 206019) 
print(my_new car.get descriptive name()) 


my_new_car.odometer reading = 23 
my_new_car.read odometer() 


@@ 处 的 import 语句 让 Python 打开 模块 car 并 导入 其 中 的 Car 类 。 这 
样 ， 我 们 就 可 以 使 用 Car 类 ， 就 像 它 是 在 i 这 个 文件 中 定义 的 一 样 。 
输出 与 我 们 在 前 面 看 到 的 一 样 : 


2019 Audi A4 
This car has 23 miles on it. 


导入 类 是 一 种 有 效 的 编程 方式 。 如 果 这 个 程序 包含 整 个 Class 类 ， 
它 该 有 多 长 啊 ! 通过 将 这 个 类 移 到 一 个 模块 中 并 导入 该 模块 ， 依 然 
可 以 使 用 其 所 有 功能 ， 但 主 程序 文件 变 得 整洁 而 易于 阅读 了 。 这 还 
让 你 能 够 将 六 部 分 进香 存储 在 独立 的 文件 中 。 确 定 关 像 你 布 望 的 屠 
样 工作 后 ， 束 可 以 不 管 这 些 文件 ， 而 专注 于 主 程序 的 高 级 逻辑 了 。 


9.4.2 ”在 一 个 模块 中 存储 多 个 类 


虽然 同一 个 模块 中 的 类 之 间 应 存在 某 种 相关 性 ， 但 可 根据 需要 在 一 
个 模块 中 存储 任意 数量 的 类 。Battery 类 和 ElectricCar 类 都 可 
帮助 模拟 汽车 ， 下 面 将 它们 都 加 入 模块 car.py 中 


car.py 


组 用 于 表示 燃油 汽车 和 电动 汽车 的 类 。""" 


class Car: 
--Snip-- 


class Battery : 
"" 一 次 模拟 电动 汽车 电瓶 的 简单 尝试 。""" 


ges it _ (self, battenys size=75): 
"初始 化 电瓶 的 属性 。' 


self.battery size = battery_ size 


IT 广 


def describe _battery(self): 
'" 打 印 一 条 描述 电瓶 容量 的 消息 。""" 
print(f" This car has a {self.battery size}-kWh battery.") 


def get range(self): 
"" 打 印 一 条 描述 电瓶 多 
if self. batter ele == 75: 


range = 260 
elif self.battery size == 166: 
range = 315 


print(f"This car can go about {range} miles on a full charge." 


class, ElectricCar( Car): 


"模拟 电动 汽车 的 独特 之 处 。 


def _ init (self, make, model, year): 


初始 化 父 类 的 属性 
再 初始 化 电动 汽车 特有 的 属性 。 


语 


super(). init (make, model, year) 
self.battery = Battery() 


现在 ， 可 以 新 建 一 个 名 为 my_electric_car.py 的 文件 ， 导 
入 ElectricCar 类 ， 并 创建 一 辆 电动 汽车 了 : 


my_electric_car.py 


from car import ElectricCar 
my_tesla = ElectricCar('tesla', 'model s', 2019) 


print(my_ tesla.get descriptive name()) 
my_tesla.battery.describe battery() 
my_tesla.battery.get_range() 


输出 与 我 们 在 前 面 看 到 的 相同 ， 但 大 部 分 逻辑 隐藏 在 一 个 模块 中 : 


2619 Tesla Model S 
This car has a 75-kWh battery. 


This car can go about 266 miles on a full charge. 


9.4.3 ”从 一 个 模块 中 导入 多 个 类 


可 根据 需要 在 程序 文件 中 导入 任意 数量 的 类 。 如 果 要 在 同一 个 程序 
中 创建 普通 汽车 和 电动 汽车 ， 就 需要 将 Car 类 和 ElectricCar 类 都 
导入 : 


my_cars.py 


@ from car import Car, ElectricCar 


@ my_beetle = Car('volkswagen', 'beetle', 20619) 
print(my_beetle.get descriptive name()) 


@ my _tesla = ElectricCar('tesla', 'roadster', 20819) 
print(my_ tesla.get descriptive name()) 


在 @@ 处 从 一 个 模块 中 导入 多 个 类 时 ， 用 逗号 分 隔 了 各 个 类 。 导 入 必 
要 的 类 后 ， 就 可 根据 需要 创建 每 个 类 的 任意 数量 实例 。 


在 本 例 中 ， 在 全 处 创建 了 一 辆 大 众 甲 壳 虫 普通 汽车 ， 并 在 候 处 创建 
了 一 辆 特 斯 拉 Roadster 电 动 汽车 : 


2619 Volkswagen Beetle 
2619 Tesla Roadster 


9.4.4 导入 整个 模块 

还 可 以 村 入 整个 模块 ， 再 使 用 句点 表示 法 访问 需要 的 类 。 这 种 导入 
方式 很 简单 ， 代 码 也 易于 阅读 。 因 为 创建 类 实例 的 代码 都 包含 模块 
名 ， 所 以 不 会 与 当前 文件 使 用 的 任何 名 称 发 生 冲 突 。 


i 


my_cars.py 


@ import car 


@ my_beetle = car.Car('volkswagen', 'beetle', 20819) 
print(my_beetle.get descriptive name()) 


@ my_tesla = car.ElectricCar('tesla', 'roadster', 20619) 
print(my_ tesla.get descriptive name()) 


在 @ 处 ， 导 入 了 整个 car 模块 。 接 下 来 ， 使 用 语法 
modulLe_name.CLassName 访问 需要 的 类 。 像 前 面 一 样 ， 在 全 处 创 
建 一 辆 大 众 甲 壳 虫 汽车 ， 并 在 个 处 创建 一 辆 特 斯 拉 Roadster 汽 车 。 


9.4.5 “导入 模块 中 的 所 有 类 
要 导入 模块 中 的 每 个 类 ， 可 使 用 下 面 的 语法 : 


from module name import * 


不 推荐 使 用 这 种 导入 方式 ， 原 因 有 二 。 第 一 ， 如 果 只 看 文件 开头 的 
import 语句 ， 束 能 清楚 地 知道 程序 使 用 了 哪些 类 ， 将 大 有 神 益 。 

然而 这 种 导入 方式 没有 明确 地 指出 使 用 了 模块 中 的 哪些 类 。 第 二 ， 
这 种 方式 还 可 能 引发 名 称 方面 的 迷惑 。 如 果 不 小 心 导 入 了 一 个 与 程 
序 文 件 中 其 他 东西 同名 的 类 ， 将 引发 难以 诊断 的 错误 。 这 里 之 所 以 
介绍 这 种 导入 方式 ， 是 因为 虽然 不 推荐 使 用 ， 但 你 可 能 在 别人 编写 
的 代码 中 见 到 它 。 


需要 从 一 个 模块 中 导入 很 多 类 时 ， 最 好 导入 整个 模块 ， 并 使 用 
moduLe_name.CLassName 语法 来 访问 类 。 这 样 做 时 ， 虽 然 文件 开 
头 并 没有 列 出 用 到 的 所 有 类 ， 但 你 清楚 地 知道 在 程序 的 哪些 地 方 使 
0 
冲突 。 


9.4.6 在 一 个 模块 中 导入 力 一 个 模块 


有 了 时候， 需要 将 类 分 散 到 多 个 模块 中 ， 以 免 模 块 太 大 或 在 同一 个 模 
块 中 存储 不 相关 的 类 。 将 类 存储 在 多 个 模块 中 时 ， 你 可 能 会 及 现 一 
个 模块 中 的 类 依赖 于 力 一 个 模块 中 的 类 。 在 这 种 情况 下 ， 可 在 前 一 
个 模块 中 导入 必要 的 类 。 


下 面 将 Car 类 存储 在 一 个 模块 中 ， 并 将 ElectricCar 类 和 Battery 
类 存储 在 另 一 个 模块 中 。 将 第 二 个 模块 命名 为 electric_car.py〈 这 将 
敌 羡 前面 创 建 的 文件 electric_car.py) ， 并 将 Battery 类 和 
ElectricCar 类 复制 到 这 个 模块 中 : 


electric_car.py 


"一 组 可 用 于 表示 电动 汽车 的 类 。""" 


@ from car import Car 


class Battery: 
--Snip-- 


class ElectricCar(Car): 
--Snip-- 


ElectricCar 类 需要 访问 其 父 类 Car ， 因 此 在 @@ 处 直接 将 Car 类 导 
入 该 模块 中 。 如 果 忘 记 了 这 行 代码 ，Python 将 在 我 们 试图 创建 
ElectricCar 实例 时 引发 错误 。 还 需要 更 新 模块 car ， 使 其 只 包 
含 Car 类 : 


car.py 


“"" 一 个 可 用 于 表示 汽车 的 类 。""" 


class Car: 
--Snip-- 


以 分 别 从 每 个 模块 中 导入 类 ， 以 根据 需要 创建 任何 类 型 的 汽 
可 这 


my_cars.py 


@ from car import Car 
from electric car import ElectricCar 


my_beetle = Car('volkswagen', 'beetle', 20619) 
print(my_beetle.get descriptive name()) 


my_tesla = ElectricCar('tesla', 'roadster', 20619) 
print(my tesla.get descriptive name()) 


在 @ 处 ， 从 模块 car 中 导入 了 Car 类 ， 并 从 模块 electric_car 中 
导入 ElectricCar 类 。 接 下 来 ,创建 了 一 辆 普通 汽车 和 一 辆 电动 


汽车 。 这 两 种 汽车 都 被 正确 地 创建 出 来 了 : 


2619 Volkswagen Beetle 
2619 Tesla Roadster 


9.4.7 ”使 用 别名 


第 8 半 说 过 ， 使 用 模块 来 组 织 项 目 代 码 时 ， 别 名 大 有 神 益 。 叶 入 类 
时 ， 也 可 为 其 指定 别名 。 


例如 ， 要 在 程序 中 创建 大 量 电动 汽车 实例 ， 需 要 反复 输 


入 ElectricCar ， 非 常 烦琐 。 为 避免 这 种 烦恼 ， 可 在 import 语句 
中 给 ElectricCar 指定 一 个 别名 : 


from electric car import ElectricCar as EC 


现在 每 当 需 要 创建 电动 汽车 实例 时 ， 都 可 使 用 这 个 别名 : 


my_tesla = EC('tesla', "roadster' ，2619) 


9.4.8 目 定 义工 作 流程 


如 你 所 见 ， 在 组 织 大 型 项 目的 代码 方面 ，Python 提 供 了 很 多 选项 。 
熟悉 所 有 这 些 选项 很 重要 ， 这 样 你 才能 确定 哪 种 项 目 组 织 方式 是 最 
佳 的 ， 并 能 理解 别人 开发 的 项 目 。 


一 开始 应 让 代码 结构 尽 可 能 简单 。 先 尽 可 能 在 一 个 文件 中 完成 所 有 
的 工作 ， 确 定 一 切 都 能 正确 运行 后 ， 再 将 类 移 到 独立 的 模块 中 。 如 
打 你 喜欢 模块 和 文件 的 交互 方式 ， 可 在 项 目 开 始 时 惑 符 试 将 类 存储 
0 


动手 试 一 斌 


练习 9-10: 导入 Restaurant 类 将 最 新 的 Restaurant 类 存 
储 在 一 个 模块 中 。 在 另 一 个 文件 中 ， 导 入 Restaurant 类 ， 创 
建 一 个 Restaurant 实例 并 调用 Restaurant 的 一 个 方法 ， 以 
确认 import 语句 正确 无 误 。 


练习 9-11: 导入 Admin 类 以 为 完成 练习 9-8 而 做 的 工作 为 基 
础 。 将 User 类 、Privileges 类 和 Admin 类 存储 在 一 个 模块 

中 ， 再 创建 一 个 文件 ， 在 其 中 创建 一 个 Admin 实例 并 对 其 调用 
方法 show_privileges() ， 以 确认 一 切 都 能 正确 运行 。 


练习 9-12: 多 个 模块 ”将 User 类 存储 在 一 个 模块 中 ， 并 

将 privileges 类 和 Admin 类 存储 在 另 一 个 模块 中 。 再 创建 一 
个 文件 ， 在 其 中 创建 一 个 Admin 实例 并 对 其 调用 方法 
show_privileges() ， 以 确认 一 切 依然 能 够 正确 运行 。 


9.5 “Python 标准 库 


Python 标准 库 是 一 组 模块 ， 我 们 安装 的 Python 都 包含 它 。 你 现在 对 
函数 和 类 的 工作 原理 已 有 大 致 的 了 解 ， 可 以 开始 使 用 其 他 程序 员 编 
号 好 的 柑 岂 了 。 可 以 使 用 标准 库 中 的 任何 函数 和 类 ， 只 需 在 程序 开 
头 包含 一 条 简单 的 jmport 语句 即 可 。 下 面 来 看 看 模块 random ， 它 
在 你 模拟 很 多 现实 | 博 况 时 很 有 用 。 


在 这 个 模块 中 ， 一 个 有 趣 的 函数 是 randint() 。 它 将 两 个 整数 作为 
参数 ， 并 随机 返回 一 个 位 于 这 两 个 整数 之 间 〈 含 ) 的 整数 。 下 面 演 
示 了 如 何 生 成 一 个 位 于 1 和 6 之 间 的 随机 整数 : 


>>> from random import randint 
>>> randint(1, 6) 
3 


在 模块 random 中 ， 另 一 个 有 用 的 函数 是 choice() 。 它 将 一 个 列表 
或 元 组 作为 参数 ， 并 随机 返回 其 中 的 一 个 元 素 : 


>>> from random import choice 

>>> players = ['charles', 'martina', 'michael', 'florence', 'eli'] 
>>> first up = choice(players) 

>>> first up 


'florence' 


创建 与 安全 相关 的 应 用 程序 时 ， 请 不 要 使 用 模块 random ， 但 该 模 
块 可 以 很 好 地 用 于 创建 众多 有 趣 的 项 目 。 


注意 ”还 可 以 从 其 他 地 方 下 载 外 部 模块 。 第 二 部 分 的 每 个 项 
目 都 需要 使 用 外 部 模块 ， 届 时 你 将 看 到 很 多 此 类 示例 。 


动手 试 一 试 


练习 9-13: 朋 子 “创建 一 个 Die 类 ， 它 包含 一 个 名 为 sides 的 
属性 ， 该 属性 的 默认 值 为 6。 编 写 一 个 名 为 rol1_die() 的 方 
法 ， 它 打印 位 于 1 和 骨 子 面 数 之 间 的 随机 数 。 创 建 一 个 6 面 的 般 
子 再 掷 10 次 。 


创建 一 个 10 面 的 角 子 和 一 个 20 面 的 角 子 ， 再 分 别 挤 10 次 。 


练习 9-14: 彩票 ”创建 一 个 列表 或 元 组 ， 其 中 包含 10 个 数 和 5 
个 字母 。 从 这 个 列表 或 元 组 中 随机 选择 4 个 数 或 字母 ， 并 打印 
条 消 县 ， 指 出 只 要 彩票 上 是 这 4 个 数 或 字母 ， 就 中 大 奖 了 。 


练习 9-15: 彩票 分 机 ”可 以 使 用 一 个 循环 来 明日 前 述 彩 票 

奖 有 多 难 中 奖 。 为 此 ， 创 建 一 个 名 为 my_ticket 的 列表 或 元 
组 ， 再 编写 一 个 循环 ， 不 断 地 随机 选择 数 或 字母 ， 直 到 中 大 奖 
为 止 。 请 打印 一 条 消 轧 ， 报 告 执行 循环 多 少 次 才 中 了 大 奖 。 


练习 9-16: Python Module of the Week 要 了 解 Python 标 准 
库 ， 一 个 很 不 错 的 资源 是 网 站 Python Module of the Week。 请 
访问 该 网 站 并 但 看 其 中 的 目录 ， 找 一 个 你 感 兴趣 的 模块 进行 探 
索 。 从 模块 random 开始 可 能 是 个 不 错 的 选择 。 


9.6 ”类 编码 风格 


你 必须 熟悉 有 些 与 类 相关 的 编码 风格 问题 ， 在 编写 的 程序 较 复 杂 时 
尤其 如 此 。 


类 名 应 采用 驼峰 命名 法 ， 即 将 类 名 中 的 每 个 单词 的 首 字母 都 大 
写 ， 而 不 使 用 下 划 线 。 实 例 名 和 模块 名 都 采用 小 写 格式 ， 并 在 单词 
之 间 加 上 下 划 线 。 


对 于 每 个 类 ， 都 应 紧 跟 在 类 定义 后 面包 含 一 个 文档 字符 串 。 这 种 文 
档 字符 串 简要 地 摘 述 类 的 功能 ， 并 遵循 编写 函数 的 文档 字符 串 时 采 
用 的 格式 约定 。 每 个 模块 也 都 应 包含 一 个 文档 字符 串 ， 对 其 中 的 类 
可 用 于 做 什么 进行 描述 。 


可 使 用 空 行 来 组 织 代码 ， 但 不 要 小 用。 在 类 中 ， 可 使 用 一 个 空 行 来 
分 隔 方 法 ;而 在 模块 中 ， 可 使 用 两 个 空 行 来 分 隔 类 。 


需要 同时 导入 标准 库 中 的 模块 和 你 编写 的 模块 时 ， 先 编写 导入 标准 
库 模块 的 ijmport 语句 ， 再 添加 一 个 空 行 ， 然 后 编写 导入 你 自己 编 
写 的 模块 的 Import 语句 。 在 包含 多 条 import 语句 的 程序 中 ， 这 种 
做 法 让 人 更 容易 明白 程序 使 用 的 各 个 模块 都 来 自 何 处 。 


9.7 小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 编写 类 ; 如 何 使 用 属性 在 类 中 存储 信 

恩 ， 以 及 如 何 编写 方法 ， 以 让 类 具备 所 需 的 行为 ， 如 何 编写 方法 

__init _() ， 以 便 根据 类 创建 包含 所 需 属性 的 实例 。 你 见识 了 如 
何 修改 实例 的 属性 ， 包 括 直接 修改 以 及 通过 方法 进行 修改 。 你 还 了 
解 了 使 用 继承 可 简化 相关 类 的 创建 工作 ， 以 及 将 一 个 类 的 实例 用 作 
另 一 个 类 的 属性 可 让 类 更 简洁 。 


你 了 解 到 ， 通 过 将 类 存储 在 模块 中 ， 并 在 需要 使 用 这 些 类 的 文件 中 
导入 它们 ， 可 让 项 目 组 织 有 序 。 你 学 习 了 Python 标准 库 ， 并 见识 了 
一 个 使 用 模块 random 的 示例 。 最 后 ， 你 学 习 了 编写 类 时 应 遵循 的 
Python 约 定 。 


在 第 10 半 中， 你 将 学 习 如 何 使 用 文件 ， 这 让 你 能 够 保存 你 在 程序 中 
所 做 的 工作 ， 以 及 你 让 用 户 做 的 工作 。 你 还 将 学 习 异 常 ， 这 是 一 
种 特殊 的 Python 类 ， 用 于 帮助 你 在 发生 错误 时 采取 相应 的 措施 。 


第 10 章 文件 和 开锅 


本 章 中 ， 你 将 学 习 处 理 文件 ， 让 程序 能 够 快速 地 分 析 大 量 数 

据 ; 你 将 学 习 错 误 处 理 ， 避 和 免 程序 在 面 对 意 外 情形 时 骨 沉 ;你 
将 学 习 寞 常 ， 它 们 是 Python 创 建 的 特殊 对 象 ， 用 于 管理 程序 运 
行 时 出 现 的 错误 ; 你 还 将 学 习 模 块 json ， 它 让 你 能 够 保存 用 

户 数据 ， 以 免 在 程序 停止 运行 后 丢失 。 


学 习 处 理 文件 和 保存 数据 可 让 你 的 程序 使 用 起 来 更 容易 : 用 户 
将 能 够 选择 输入 什么 样 的 数据 ， 以 及 在 什么 时 候 输 入 ; 用 户 使 
用 你 的 程序 做 一 些 工 作 后 ， 可 将 程序 关闭 ， 以 后 再 接着 往 下 
做 。 学 习 处 理 异 党 可 帮助 你 应 对 文件 不 存在 的 情形 ， 以 及 人 处理 
其 他 可 能 导致 程序 骨 误 的 问题 。 这 让 你 的 程序 在 面 对 错 误 的 数 
据 时 更 健壮 ， 不 管 这 些 错误 数据 源 目 无 意 的 错误 ， 还 是 源 目 破 
坏 程 序 的 恶意 企图 。 你 在 本 章 学 习 的 技能 可 提高 程序 的 适用 
性 、 可 用 性 和 稳定 性 。 


10.1 ”从 文件 中 读 取 数据 


文本 文件 可 存储 的 数据 量 多 得 难以 置信 : 天 气 数据 、 交 通 数 据 、 社 
会 经 济 数据 、 文 学 作品 等 。 每 当 需 要 分 析 或 修改 存储 在 文件 中 的 信 
恩 时 ， 读 取 文 件 都 很 有 用 ， 对 数据 分 析 应 用 程序 来 说 尤其 如 此 。 例 
如 ， 可 以 编写 一 个 这 样 的 程序 ， 读 取 一 个 文本 文件 的 内 容 ， 重 新 设 
置 这 些 数 据 的 格式 并 将 其 写 入 文件 ， 让 浏览 器 能 够 显示 这 些 内 容 。 


要 使 用 文本 文件 中 的 信息 ， 首 先 需要 将 信息 读 取 到 内 存 中 。 为 此 ， 
你 可 以 一 次 性 读 取 文件 的 全 部 内 容 ， 也 可 以 以 每 次 一 行 的 方式 逐步 
读 取 。 


10.1.1 读 取 整个 文件 

要 读 取 文件 ， 需 要 一 个 包含 几 行 文本 的 文件 。 下 面 首先 创建 一 个 文 
件 ， 它 包含 精确 到 小 数 点 后 30 位 的 圆周 率 值 ， 且 在 小 数 点 后 每 10 位 
处 换行 : 

Pi_digits.txt 


3.1415926535 
8979323846 


2643383279 


要 动手 尝试 后 续 示 例 ， 可 在 编辑 器 中 输入 这 些 数 据 行 ， 再 将 文件 保 
存 为 pi_digits.txt， 也 可 从 本 书 主页 (ituring.cn/book/2784) 下 载 该 
文件 。 请 将 该 文件 保存 到 本 章程 序 所 在 的 目录 。 

下 面 的 程序 打开 并 读 取 这 个 文件 ， 再 将 其 内 容 显示 到 屏幕 上 : 


file_reader.py 


with open('pi digits.txt') as file object: 
contents = file object.read() 
print(contents) 


[L | 


在 这 个 程序 中 ， 第 一 行 代码 做 了 大 量 的 工作 。 我 们 移 来 看 看 函 
数 open() 。 要 以 任何 方式 使 用 文件 ， 那 介 仅 仅 是 打印 其 内 容 ， 都 
得 先 打开 文件 ， 才 能 访问 它 。 函 数 open( ) 接受 一 个 参数 : 要 打开 
的 文件 的 名 称 。Python 在 当前 执行 的 文件 所 在 的 目录 中 查找 指定 的 
文件 。 在 本 例 中 ， 当 前 运行 的 是 file_reader.py， 因 此 Python 在 
file_reader.py 所 在 的 目录 中 查找 pi_digits.txt。 疯 数 open() 返回 一 个 
表示 文件 的 对 象 。 在 这 里 ，open('pi digits.txt') 返回 一 个 表 
示 文 件 pi_digits.txt 的 对 象 ，Python 将 该 对 象 赋 给 file_object 供 以 
后 使 用 


关键 字 with 在 不 再 需要 访问 文件 后 将 其 关闭 。 在 这 个 程序 中 ， 注 
意 到 我 们 调用 了 open() ， 但 没有 调用 close() 。 也 可 以 调 

用 open() 和 close() 来 打开 和 关闭 文件 ， 但 这 样 做 时 ， 如 果 程 序 
存在 bug 叶 致 方法 close() 未 执行 ， 文 件 将 不 会 关闭。 这 看 似 微 不 
足 道 ， 但 未 妥善 关闭 文件 可 能 导致 数据 丢失 或 受 损 。 如 果 在 程序 中 
过 早 调用 close() ， 你 会 发 现 需要 使 用 文件 时 它 已 关闭 〈 无 法 访 
问 ) ， 这 会 导致 更 多 的 错误 。 并 非 在 任何 情况 下 都 能 轻松 确定 关闭 
文件 的 恰当 时 机 ， 但 通过 使 用 前 面 所 示 的 结构 ， 可 让 Python 去 确 
定 : 你 只 管 打 开 文 件 ， 并 在 需要 时 使 用 它 ，Python 自 会 在 合适 的 时 
候 自 动 将 其 关闭 。 


有 了 表示 pi_digits.txt 的 文件 对 象 后 ， 使 用 方法 read() (前 述 程序 

的 第 二 行 ) 读 取 这 个 文件 的 全 部 内 容 ， 并 将 其 作为 一 个 长 长 的 字符 
串 赋 给 变量 contents 。 这 样 ， 通 过 打印 contents 的 值 ， 就 可 将 

这 个 文本 文件 的 全 部 内 容 显示 出 来 : 


3.1415926535 


8979323846 
2643383279 


相 比 于 原始 文件 ， 该 输出 唯一 不 同 的 地 方 是 末尾 多 了 一 个 空 行 。 为 
何 会 多 出 这 个 空 行 呢 ? 因为 read() 到 达 文 件 末尾 时 返回 一 个 空 字 
符 串 ， 而 将 这 个 空 字符 串 显 示 出 来 时 就 是 一 个 空 行 。 要 删除 多 出 来 
的 空 行 ， 可 在 函数 调用 print() 中 使 用 rstrip() : 


with open( "pi digits.txt') as file object: 
contents = file object.read() 


print(contents.rstrip()) 


本 书 前 面 说 过 ，Python 方 法 rstrip() 删除 字符 串 末 尾 的 空白 。 现 
在 ， 输 出 与 原始 文件 的 内 容 完 全 相同 : 


3.1415926535 
8979323846 


2643383279 


10.1.2 文件 路 径 


将 类 似 于 pi_digits.txt 的 简单 文件 名 传递 给 函数 open() 时 ，Python 将 
在 当前 执行 的 文件 〈 即 .py 程序 文件 ) 所 在 的 目录 中 查找 。 


根据 你 组 织 文件 的 方式 ， 有 时 可 能 要 打开 不 在 程序 文件 所 属 目录 中 
的 文件 。 例 如 ， 你 可 能 将 程序 文件 存储 在 了 文件 夹 python_work 
中 ， 而 该 文件 夹 中 有 一 个 名 为 text_files 的 文件 夹 用 于 存储 程序 文件 
操作 的 文本 文件 。 虽 然 文件 夹 text_files 包 含 在 文件 夹 python_work 
中 ， 但 仅 同 open() 传递 位 于 前 者 中 的 文件 名 称 也 不 可 行 ， 因 为 
Python 只 在 文件 夹 python_work 中 查找 ， 而 不 会 在 其 子 文件 夹 
text_files 中 查找 。 要 让 Python 打 开 不 与 程序 文件 位 于 同一 个 目录 中 
的 文件 ， 需 要 提供 文件 路 径 ， 让 Python 到 系统 的 特定 位 置 去 查找 。 


由 于 文件 夹 text_files 位 于 文件 夹 python_work 中 ， 可 以 使 用 相对 文件 
路 径 来 打开 其 中 的 文件 。 相 对 文件 路 径 让 Python 到 指定 的 位 置 去 得 
找 ， 当前 运行 的 程序 所 在 目录 的 。 例 如 ， 可 这 样 
编写 代码 : 


with open('text files/filename.txt') as file object: 


这 行 代码 让 Python 到 文件 夹 python_work 下 的 文件 夹 text_files 中 去 查 
找 指定 的 .txt 文 件 。 


注意 “显示 文件 路 径 时 ，Windows 系 统 使 用 反 斜 枉 〈\ ) 而 不 
古 斜 杠 (/ ) ， 但 在 代码 中 依然 可 以 使 用 和 斜 杠 。 


还 可 以 将 文件 在 计算 机 中 的 准确 位 置 告诉 Python， 这 样 就 不 用 关心 
当前 运行 的 程序 存储 在 什么 地 方 了 。 这 称 为 绝对 文件 路 径 。 在 相 
对 路 径 行 不 通 时 ， 可 使 用 绝对 路 径 。 例 如 ， 如 采 text_files 并 不 在 文 
件 夹 python_work 中 ， 而 在 文件 夹 other_files 中 ， 则 向 open() 传递 路 
径 'text_files/fiLename .txt' 行 不 通 ， 因 为 Python 只 在 文件 
夹 python_work 中 查找 该 位 置 。 为 明确 指出 希望 Python 到 哪里 去 查 
找 ， 需 要 提供 完整 的 路 径 。 


绝对 路 径 通 常 比 相对 路 径 长 ， 因 此 将 其 赋 给 一 个 变量 ， 再 将 该 变量 
传递 给 open() 会 有 所 帮助 : 


file path = '/home/ehmatthes/other files/text files/ filename .txt' 
with open(file path) as file object: 


通过 使 用 绝对 路 径 ， 可 该 取 系 统 中 任何 地 方 的 文件 。 就 目前 而 言 ， 
最 简单 的 做 法 是 ， 要 么 将 数据 文件 存储 在 程序 文件 所 在 的 目录 ， 要 
人 目录 下 的 一 个 文件 夹 〈 如 text_files ) 


注意 ”如 果 在 文件 路 径 中 直接 使 用 反 斜 杜 ， 将 引发 错误 ， 
为 反 斜 杜 用 于 对 字符 串 中 的 字符 进行 转 义 。 例 如 ， 对 于 路 
径 "C:\path\to\file.txt" ， 其 中 的 \t 将 被 解读 为 制 表 符 。 
如 果 一 定 要 使 用 反 斜 杜 ， 可 对 路 径 中 的 每 个 反 斜 杠 都 进行 转 
义 ， 如 "C:\\path\\to\\file.txt"。 


10.1.3” 逐 行 读 取 
读 取 文件 时 ， 常 常 需要 检查 其 中 的 每 一 行 : 可 能 要 在 文件 中 查找 特 


定 的 信息 ， 或 者 要 以 东 种 方式 修改 文件 中 的 文本 。 例 如 ， 你 可 能 要 
台历 一 个 包含 天 气 数据 的 文件 ， 并 使 用 天 气 描述 中 包 合 sunny 字 样 


的 行 。 在 新 闻 报 道中 ， 你 可 能 会 查找 包含 标签 cheadline> 的 行 ， 
并 按 特定 的 格式 设置 它 。 


要 以 每 次 一 行 的 方式 检查 文件 ， 可 对 文件 对 象 使 用 for 循环 : 
file_reader.py 


@ filename = "pi digits.txt' 


@ with open(filename) as file object: 


© for line in file object: 
print(line) 


在 @ 处 ， 将 要 读 取 的 文件 的 名 称 赋 给 变量 filename 。 这 是 使 用 文 
件 时 的 一 种 常见 做 法 。 变 量 filename 表示 的 并 非 实际 文 件 一 一 它 
只 是 一 个 让 Python 知 道 到 哪里 去 查找 文件 的 字符 串 ， 因 此 可 以 轻松 
地 将 'pi_digits .txt' 蔡 换 为 要 使 用 的 另 一 个 文件 的 名 称 。 调 

用 open() 后 ， 将 一 个 表示 文件 及 其 内 容 的 对 象 赋 给 了 变量 
file_object 〈 见 贸 ) 。 这 里 也 使 用 了 关键 字 with ， 让 Python 负 
贡 受 善 地 打开 和 关闭 文件 。 为 查看 文件 的 内 容 ， 通 过 对 文件 对 象 执 
行 循环 来 裔 历 文件 中 的 每 一 行 ( 见 @) 。 


打印 每 一 行 时 ， 发 现 空白 行 更 多 了: 


3.1415926535 


8979323846 


2643383279 


为 何 会 出 现 这 些 空白 行 昵 ? 因为 在 这 个 文件 中 ， 每 行 的 末尾 都 有 一 
个 看 不 见 的 换行 符 ， 而 函数 调用 print() 也 会 加 上 一 个 换行 符 ， 
此 每 行 末尾 都 有 两 个 换行 符 : 一 个 来 自 文 件 ， 另 一 个 来 自 函 数 调 

用 print() 。 要 消除 这 些 多 余 的 空白 行 ， 可 在 函数 调用 print() 中 
使 用 rstrip() : 


filename = "pi digits.txt 


with open(filename) as file object: 


for line in file object: 
print(line.rstrip()) 


现在 ， 输 出 又 与 文件 内 容 完全 相同 了 : 


3.1415926535 
8979323846 
2643383279 


10.1.4 ”创建 一 个 包含 文件 各 行内 容 的 列表 


使 用 关键 字 with 时 ，open() 返回 的 文件 对 象 只 在 with 代码 块 内 
可 用 。 如 果 要 在 with 代码 块 外 访问 文件 的 内 容 ， 可 在 with 代码 块 
内 将 文件 的 各 行 存储 在 一 个 列表 中 ， 并 在 with 代码 块 外 使 用 该 列 
表 : 可 以 立即 处 理 文件 的 各 个 部 分 ， 也 可 以 推迟 到 程序 后 面 再 处 

理 。 


下 面 的 示例 在 with 代码 块 中 将 文件 pi_digits.txt 的 各 行 存 储 在 一 个 
列表 中 ， 再 在 with 代码 块 外 打印 : 


filename = "pi digits.txt' 


with open(filename) as file object: 
@ lines = file object.readlines() 


@ for line in lines: 
print(line.rstrip()) 


@@ 处 的 方法 readlines() 从 文件 中 读 取 每 一 行 ， 并 将 其 存储 在 一 
个 列表 中 。 接 下 来 ， 该 列表 被 赋 给 变量 lines 。 在 with 代码 块 
外 ， 依 然 可 使 用 这 个 变量 。 在 全 处 ， 使 用 一 个 简单 的 for 循环 来 打 
印 1ines 中 的 各 行 。 因 为 列表 lines 的 每 个 元 素 都 对 应 于 文件 中 的 


一 行 ， 所 以 输出 与 文件 内 容 完全 一 致 。 
10.1.5 ”使 用 文件 的 内 容 
将 文件 读 取 到 内 存 中 后 ， 束 能 以 任何 方式 使 用 这 些 数据 了 。 下 面 以 


简单 的 方式 使 用 圆周 率 的 值 。 首 先 ， 创 建 一 个 字符 串 ， 它 包含 文件 
中 存储 的 所 有 数字 ， 且 没有 任何 空格 : 


pi_string.py 


filename = "pi digits.txt' 


with open(filename) as file object: 
lines = file object.readlines() 


@ pi string = "" 
@ for line in lines: 
pi_string += line.rstrip() 


@ print(pi string) 
print(len(pi string)) 


像 前 一 个 示例 一 样 ， 首 先 打开 文件 ， 并 将 其 中 所 有 的 行 都 存储 在 一 
个 列表 中 。 在 @ 处 ,创建 了 一 个 变量 pi_string ， 用 于 指向 圆周 率 
的 值 。 接 下 来 ， 使 用 一 个 循环 将 各 行 加 入 pi_string ， 并 删除 每 行 
末尾 的 换行 符 〈 见 贸 ) 。 在 全 处 ， 打 印 这 个 字符 串 及 其 长 度 : 


3.1415926535 8979323846 2643383279 
36 


变量 pi_string 指 癌 的 字符 串 包含 原来 位 于 每 行 左 边 的 空格 ， 为 市 
除 这 些 空 格 ， 可 使 用 strip() 而 非 rstrip(): 


--Snip-- 
for line in lines: 
pi_string += line.strip() 


print(pi_string) 
print(len(pi_string)) 


这 样 就 获得 了 一 个 字符 串 ， 其 中 包含 准确 到 30 位 小 数 的 圆周 率 值 。 
这 个 字符 串 长 32 字 符 ， 因 为 它 还 包含 整数 部 分 的 3 和 小 数 点 : 


3.141592653589793238462643383279 
32 


注意 读 取 文本 文件 时 ，Python 将 其 中 的 所 有 文本 都 解读 为 字 
符 捉 。 如 采 该 取 的 是 数 ， 并 要 将 其 作为 数值 使 用 ， 就 必须 使 用 
i 


10.1.6 ”包含 一 百 万 位 的 大 型 文件 


前 面 分 析 的 都 是 一 个 只 有 三 行 的 文本 文件 ， 但 这 些 代码 示例 也 可 处 
理 大 得 多 的 文件 。 如 果 我 们 有 一 个 文本 文件 ， 其 中 包含 精确 到 小 数 
点 后 1 000 000 位 而 不 是 30 位 的 圆周 率 值 ， 也 可 创建 一 个 包含 所 有 这 
些 数字 的 字符 串 。 为 此 ， 无 须 对 前 面 的 程序 做 任何 修改 ， 只 要 将 这 
个 文件 传递 给 它 即 可 。 在 这 里 ， 只 打印 到 小 数 点 后 50 位 ， 以 免 终 端 
为 显示 全 部 1 000 000 位 而 不 断 滚动 : 


pi_string.py 


filename = "pi million digits.txt' 


with open(filename) as file object: 
lines = file object.readlines() 


pi_string = "" 
for line in lines: 
pi_string += line.strip() 


print(f"{pi_ string[:52]}...") 
print(len(pi_string)) 


[L | 


创建 的 字符 串 确实 包含 精确 到 小 数 点 后 1000 000 位 的 圆 


3.14159265358979323846264338327950288419716939937516. . . 
16666062 


对 于 可 处 理 的 数据 量 ，Python 没 有 任何 限制 。 只 要 系统 的 内 存 足 够 
多 ， 你 想 处 理 多 少数 据 都 可 以 。 


注意 ”要 运行 这 个 程序 〈 以 及 后 面 的 众多 示例 ) ， 需 要 从 
http://ituring.cn/book/2784 下 载 相关 的 资源 。 


10.1.7 圆周 率 值 中 包含 你 的 生日 吗 


我 一 直 想 知道 自己 的 生日 是 否 包含 在 圆周 率 值 中 。 下 面 来 扩展 刚才 
编写 的 程序 ， 以 确定 某 个 人 的 生日 是 否 包 含 在 圆周 率 值 的 前 1 000 

000 位 中 。 为 此 ， 可 将 生日 表示 为 一 个 由 数字 组 成 的 字符 串 ， 再 检 

查 这 个 字符 串 是 否 包含 在 pi_string 中 : 


--Snip-- 
for line in lines: 
pi_string += line.strip() 


birthday = input("Enter your birthday, in the form mmddyy: ") 
if birthday in pi string: 

print("Your birthday appears in the first million digits of pi!" 
else: 

print("Your birthday does not appear in the first million digits 


在 @ 处 ， 提 示 用 户 输 入 生日 。 在 全 处 ， 检 查 这 个 字符 串 是 否 包 含 
在 pi_string 中 。 下 面 来 运行 一 下 这 个 程序 : 


Enter your birthdate, in the form mmddyy: 120372 
Your birthday appears :in the first million digits of pil 


| | 


我 的 生日 确实 出 现在 了 圆周 率 值 中 ! 读 取 文件 的 内 容 后 ， 能 以 你 能 
想到 的 任何 方式 对 其 进行 分 析 。 


动手 试 一 斌 


练习 10-1: Python 学 习 笔 记 “在 文本 编辑 器 中 新 建 一 个 文 

件 ， 写 几 名 话 来 总 结 一 下 你 至 此 学 到 的 Python 知识 ， 其 中 每 一 
行 都 以 “In Python you can? 打 头 。 将 这 个 文件 命名 为 
learning_python.txt， 并 存储 到 为 完成 本 章 练 习 而 编写 的 程序 所 
在 的 目录 中 。 编 写 一 个 程序 ， 它 读 取 这 个 文件 ， 并 将 你 所 写 的 
内 容 打 印 三 次 : 第 一 次 打印 时 读 取 整个 文件 ， 第 二 次 打印 时 裔 
历 文件 对 象 ， 第 三 次 打印 时 将 各 行 存 储 在 一 个 列表 中 ， 再 

在 with 代码 块 外 打印 它们 。 


练习 10-2: C 语 言 学 习 笔 记 。 可 使 用 方法 replace() 将 字符 串 
中 的 特定 单词 都 蔡 换 为 男 一 个 单词 。 下 面 是 一 个 简单 的 示例 ， 
演示 了 如 何 将 句子 中 的 'dog' 蔡 换 为 'cat': 


>>> message = "I really like dogs." 
>>> message.replace('dog', 'cat') 


'I really like cats.' 


读 取 你 刚 创 建 的 文件 learning_python.txt 中 的 每 一 行 ， 将 其 中 的 
Python 都 蔡 换 为 另 一 门 语言 的 名 称 ， 比 如 C。 将 修改 后 的 各 行 
都 打印 到 屏幕 上 。 


10.2” 写 入 文件 


保存 数据 的 最 简单 的 方式 之 一 是 将 其 写 入 文件 中 。 通 过 将 输出 写 入 
文件 ， 即 便 关 闭 包含 程序 输出 的 终端 窗口 ， 这 些 输出 也 依然 存在 : 
可 以 在 程序 结束 运行 后 查看 这 些 输出 ， 可 以 与 别人 分 享 输出 文件 ， 
还 可 以 编写 程序 来 将 这 些 和 输出 读 取 到 内 存 中 并 进行 处 理 。 


10.2.1 写 入 空 文件 

要 将 文本 写 入 文件 ， 你 在 调用 open() 时 需要 提供 另 一 个 实 参 ， 告 
诉 Python 你 要 写 入 打开 的 文件 。 为 明白 其 中 的 工作 原理 ， 我 们 来 将 
一 条 简单 的 消息 存储 到 文件 中 ， 而 不 是 将 其 打印 到 屏幕 上 : 


write_message.py 


filename = 'programming.txt" 
@ with open(filename, 'w') as file object: 


@ file object.write("I love programming.") 


在 本 例 中 ， 调 用 open() 时 提供 了 两 个 实 参 ( 见 @)〉。 第 一 个 实 参 
也 是 要 打开 的 文件 的 名 称 。 第 二 个 实 参 ('w' ) 告诉 Python， 要 以 
写 入 模式 打开 这 个 文件 。 打 开 文件 时 ， 可 指定 读 取 模式 〈'r， 
) 、 写 入 模式 ('w' ) 、 附 加 模式 〈'a' ) 或 读 写 模式 〈'r+， 
) 。 如 果 省 略 了 模式 实 参 ，Python 将 以 默认 的 只 读 模式 打开 文件 。 


如 果 要 写 入 的 文件 不 存在 ， 函 数 open() 将 自动 创建 它 。 然 而 ， 以 
写 入 模式 ('w" ) 打开 文件 时 千 万 要 小 心 ， 因 为 如 果 指 定 的 文件 已 
经 存在 ，Python 将 在 返回 文件 对 象 前 清空 该 文件 的 内 容 。 


在 四 处 ， 使 用 文件 对 象 的 方法 write() 将 一 个 字符 串 写 入 文件 。 这 
个 程序 没有 终端 输出 ， 但 如 果 打 开 文 件 programming.txt， 将 看 到 其 
中 包含 如 下 一 行内 容 : 


programming.txt 


I love programming. 


相 比 于 计算 机 中 的 其 他 文件 ， 这 个 文件 没有 什么 不 同 。 你 可 以 打开 
它 、 在 其 中 输入 新 文本 、 复 制 其 内 容 、 将 内 容 粘贴 到 其 中 ， 等 等 。 


注意 ”Python 只 能 将 字符 冲 写 入 文本 文件 。 要 将 数值 数据 存储 
到 文本 文件 中 ， 必 须 先 使 用 函数 str() 将 其 转换 为 字符 串 格 


式 。 


10.2.2 写 入 多 行 


函数 write() 不 会 在 写 入 的 文本 末尾 添加 换行 从 ， 因 此 如 果 写 入 多 
行 时 没有 指定 换行 符 ， 文 件 看 起 来 可 能 不 是 你 希望 的 那样 : 


filename = 'programming.txt' 


with open(filename, 'w') as file object: 


file object.write("I love programming.") 
file object.write("I love creating new games.") 


如 果 你 打开 programming.txt， 将 发 现 两 行内 容 挤 在 一 起 : 


I love programming.I love creating new games. 


要 让 每 个 字符 串 痢 单独 占 一 行 ， 需要 在 方法 调用 write() 中 包含 换 


但 付 -: 


filename = 'programming.txt' 


with open(filename, 'w') as file object: 


file object.write("I love programming.\n") 
file object.write("I love creating new games.\n") 


现在 ， 输 出 出 现在 不 同 的 行 中 : 


I love programming. 
I love creating new games. 


像 显 示 到 终端 的 输出 一 样 ， 还 可 以 使 用 空格 、 制 表 符 和 空 行 来 设置 
这 些 输出 的 格式 。 


10.2.3 ”附加 到 文件 


如 果 要 给 文件 添加 内 容 ， 而 不 是 窗 盖 原 有 的 内 容 ， 可 以 以 附加 模式 
打开 文件 。 以 附加 模式 打开 文件 时 ，Python 不 会 在 返回 文件 对 象 前 
清空 文件 的 内 容 ， 而 是 将 写 入 文件 的 行 添加 到 文件 末尾 。 如 有 果 指 定 
的 文件 不 存在 ，Python 将 为 你 创建 一 个 空 文件 。 


下 面 来 修改 write_message.py， 在 既 有 文件 programming.txt 中 再 添加 
一 些 你 酷爱 编程 的 原因 : 


write_message.py 


filename = 'programming.txt" 


@ with open(filename, 'a') as file object: 


@ file object.write("I also love finding meaning in large datasets 
file object.write("I love creating apps that can run in a browse 


在 @ 处 ， 打 开 文 件 时 指定 了 实 参 'a' ， 以 便 将 内 容 附 加 到 文件 末 
尾 ， 而 不 是 有 宪 新 文件 原来 的 内 容 。 在 全 处 ， 又 写 入 了 两 行 ， 它 们 被 
添加 到 文件 programming.txt 末 尾 : 


programming.txt 


I love programming. 

I love creating new games. 

I also love finding meaning in large datasets. 
I love creating apps that can run in a browser. 


| 


最 终 的 结果 是 ， 文 件 原来 的 内 容 还 在 ， 后 面 则 是 刚 添加 的 内 容 。 
动手 试 一 斌 


练习 10-3: 访客 ”编写 一 个 程序 ， 提 示 用 户 输入 名 字 。 用 户 做 
出 啊 应 后 ， 将 其 名 字 写 入 文件 guest.txt 中 。 


练习 10-4: 访客 名 单 ”编写 一 个 while 循环 ， 提 示 用 户 输入 
名 字 。 用 户 输入 名 字 后 ， 在 屏幕 上 打印 一 句 问候 语 ， 并 将 一 条 
到 访 记 录 添 加 到 文件 guest_book.txt 中 。 确 保 这 个 文件 中 的 每 条 
记录 都 独占 一 行 。 


练习 10-5: 调查 ”编写 一 个 while 循环 ， 询 问 用 户 为 何 喜欢 编 
程 。 每 当 用 户 输入 一 个 原因 后 ， 都 将 其 添加 到 一 个 存储 所 有 原 
因 的 文件 中 。 


10.3 ”异常 


Python 使 用 称 为 异常 的 特殊 对 象 来 管理 程序 执行 期 间 发 生 的 错误 。 
每 当 发 生 让 Python 不 知 所 措 的 错误 时 ， 它 都 会 创建 一 个 异常 对 象 。 
如 果 你 编写 了 处 理 该 异常 的 代码 ， 程 序 将 继续 运行 ， 如 果 示 对 异常 
进行 处 理 ， 程序 将 停止 并 显示 traceback， 其 中 包含 有 关 异 常 的 报 
百 。 


异常 是 使 用 try-except 代码 块 处 理 的 。try-except 代码 块 让 
Python 执 行 指 定 的 操作 ， 同 时 告诉 Python 发 生 异 常 时 怎么 办 。 使 
用 try-except 代码 块 时 ， 即 便 出 现 异常 ， 程 序 也 将 继续 运行 : 显 
示 你 编写 的 友好 的 错误 消息 ， 而 不 是 令 用 户 迷 惑 的 traceback。 


10.3.1 处理 ZeroDivisionError 异常 


下 面 来 看 一 种 导致 Python 引 发 异常 的 简单 错误 。 你 可 能 知道 ， 不 能 
用 数 除 以 0， 但 还 是 让 Python 这 样 做 : 


division_calculator.py 


和 


显然 ，Python 无 法 这 样 做 ， 因 此 你 将 看 到 一 个 traceback: 


Traceback (most recent call last): 
File "division calculator.py", line 1, in <module> 
print(5/6) 


@ ZeroDivisionError: division by zero 


在 上 述 traceback 中 ，@ 处 指出 的 错误 ZeroDivisionError 是 个 异 
币 对 象 。Python 无 法 按 你 的 要 求 做 时 ， 束 会 创建 这 种 对 象 。 在 这 种 
情况 下 ，Python 将 停止 运行 程序 ， 并 指出 引发 了 哪 种 异常 ， 而 我 们 
可 根据 这 些 信息 对 程序 进行 修改 。 下 面 来 告诉 Python， 发 生 这 种 错 


误 时 怎么 办 。 这 样 ， 如 果 再 次 发 生 此 类 错误 ， 我 们 就 有 备 无 患 了 。 
10.3.2 ”使 用 try-except 代码 块 
当 你 认为 可 能 会 发 生 错误 时 ， 可 编写 一 个 try-except 代码 块 来 处 
理 可 能 引发 的 异常 。 你 让 Python 演 试 运行 一 些 代 码 ， 并 告诉 它 如 果 
这 些 代 码 引 发 了 指定 的 异常 该 怎么 办 。 


处 理 ZeroDivisionError 异常 的 try-except 代码 块 类 似 于 下 面 
这 样 : 


try: 
print(5/6) 
except ZeroDivisionError: 


print("You can't divide by zero!") 


将 导致 错误 的 代码 行 print(5/8) 放 在 一 个 try 代码 块 中 。 如 果 
try 代码 块 中 的 代码 运行 起 来 没有 问题 ，Python 将 跳 过 except 代 
码 块 :如果 try 代码 块 中 的 代码 导致 了 错误 ，Python 将 查找 与 之 匹 
配 的 except 代码 块 并 运行 其 中 的 代码 。 


在 本 例 中 ，try 代码 块 中 的 代码 引发 了 ZeroDivisionError 异 
常 ， 因 此 Python 查找 指出 了 该 怎么 办 的 except 代码 块 ， 并 运行 其 
中 的 代码 。 这 样 ， 用 户 看 到 的 是 一 条 友好 的 错误 消息 ， 而 不 是 


traceback: 


You can't divide by zero! 


如 果 try-except 代码 块 后 面 还 有 其 他 代码 ， 程 序 将 接着 运行 ， 因 
为 已 经 告诉 了 Python 如 何 处 理 这 种 错误 。 下 面 来 看 一 个 捕获 错误 后 
程序 继续 运行 的 示例 。 

10.3.3 ”使 用 异常 避免 月 演 

发 生 错 误 时 ， 如 果 程 序 还 有 工作 尚未 完成 ， 受 善 地 处 理 错误 就 尤其 


重要 。 这 种 情况 经 币 会 出 现在 要 求 用 户 提 供 输入 的 程序 中 ;， 如 宋 程 
序 能 够 受 善 地 处 理 无 效 输入 ， 束 能 再 提示 用 户 提供 有 效 输入 ， 而 不 
全 于 衣 误 。 


下 面 来 创建 一 个 只 执行 除法 运算 的 简单 计算 器 : 


division_calculator.py 


print("Give me two numbers, and I'11 divide them.") 
print("Enter 'q' to quit.") 


while True: 
@ first number = input("\nFirst number: ") 
if first number == 'q': 
break 
second number = input("Second number: ") 
if second number == 'q": 
break 
answer = int(first number) / int(second number) 
print(answer) 


在 @ 处 ， 程 序 提示 用 户 输入 一 个 数 ， 并 将 其 赋 给 变量 
first_number 。 如 果 用 户 输入 的 不 是 表示 退出 的 q ， 就 再 提示 用 
户 输 入 一 个 数 ， 并 将 其 赋 给 变量 second_number ( 见 @@) 。 接 下 
来 ， 计 算 这 两 个 数 的 商 ( 见 @) 。 该 程序 没有 采取 任何 处 理 错误 的 
音 施 ， 因 此 在 执行 除数 为 0 的 除法 运算 时 ， 它 将 骨 溃 : 


Give me two numbers, and I'11 divide them. 
Enter 'q” to quit . 


First number: 5 
Second number: 0 


Traceback (most recent call last): 
File "division calculator.py", line 9, in <module> 
answer = int(first number) / int(second number) 
ZeroDivisionError: division by zero 


程序 骨 尝 可 不 好 ， 但 让 用 户 看 到 traceback 也 不 是 个 好 主意 。 不 懂 技 


术 的 用 户 会 被 摘 糊 涂 ， 怀 有 恶意 的 用 户 还 会 通过 traceback 获 悉 你 不 
想 他 知道 的 信息 。 例 如 ， 他 将 知道 你 的 程序 文件 的 名 称 ， 还 将 看 到 
部 分 不 能 正确 运行 的 代码 。 有 时 候 ， 训 练 有 素 的 攻击 者 可 根据 这 些 
言 息 判断 出 可 对 你 的 代码 发 起 什么 样 的 攻击 。 


10.3.4 ”else 代码 块 


通过 将 可 能 引发 错误 的 代码 放 在 try-except 代码 块 中 ， 可 提高 程 

序 抵 御 错 误 的 能 力 。 错 误 是 执行 除法 运算 的 代码 行 导致 的 ， 因 此 需 
要 将 它 放 到 try-except 代码 块 中 。 这 个 示例 还 包含 一 个 else 代码 
块 。 依 赖 try 代码 块 成 功 执行 的 代码 都 应 放 到 else 代码 块 中 : 


--Snip-- 
while True : 
--Snip-- 
if second number == 'q': 
break 


try: 


answer = int(first number) / int(second number) 
except ZeroDivisionError: 

print("You can't divide by 68!") 
else: 

print(answer) 


让 Python 尝试 执行 try 代码 块 中 的 除法 运算 ( 见 @) ， 这 个 代码 块 
只 包含 可 能 导致 错误 的 代码 。 依 赖 try 代码 块 成 功 执 行 的 代码 都 放 
在 else 代码 块 中 。 在 本 例 中 ， 如 果 除 法 运算 成 功 ， 束 使 用 else 代 
码 块 来 打印 结果 ( 见 @) 。 


except 代码 块 告诉 Python， 出 现 ZeroDivisionError 异常 时 该 如 
何 办 〔 见 介 ) 。 如 果 try 代码 块 因 除 零 错误 而 失败 ， 就 打印 一 条 友 
好 的 消息 ， 告 诉 用 户 如 何 避 免 这 种 错误 。 程 序 继续 运行 ， 用 户 根 本 
看 不 到 traceback: 


Give me two numbers, and I'1l1 divide them. 
Enter 'q' to quit. 


First number: 5 
Second number: 6 


You can't divide by 6! 
First number: 5 
Second number: 2 


2.5 


First number: 9q 


try-except-else 代码 块 的 工作 原理 大 致 如 下 。Python 答 试 执 


行 try 代码 块 中 的 代码 ， 只 有 可 能 引发 异常 的 代码 才 需 要 放 在 try 
语句 中 。 有 时 候 ， 有 一 些 仅 在 try 代码 块 成 功 执行 时 才 需 要 运行 的 
代码 ， 这 些 代码 应 放 在 else 代码 块 中 。except 代码 块 告诉 
js 
已 从 人 。 


通过 预测 可 能 发 生 错误 的 代码 ， 可 编写 健壮 的 程序 。 它 们 即便 面临 
i 也 能 继续 运行 ， 从 而 抵御 无 意 的 用 户 错误 和 
恶意 的 攻击 。 


10.3.5 ”处 理 FileNotFoundError 异常 

使 用 文件 时 ， 一 种 常见 的 问题 是 找 不 到 文件 ， 查找 的 文件 可 能 在 其 
他 地 方 ， 文 件 名 可 能 不 正确 ， 或 者 这 个 文件 根本 就 不 存在 。 对 于 所 
有 这 些 情形 ， 都 可 使 用 try-except 代码 块 以 直观 的 方式 处 理 。 


我 们 来 尝试 读 取 一 个 不 存在 的 文件 。 下 面 的 程序 尝试 读 取 文件 
alice.txt 的 内 容 ， 但 该 文件 没有 存储 在 alice.py 所 在 的 目录 中 : 


alice.py 


filename = "alice.txt' 


with open(filename, encoding="'utf-8') as f: 


contents = f.read() 


相 比 于 本 章 前 面 的 文件 打开 方式 ， 这 里 有 两 个 不 同 之 处 。 一 是 使 用 


变量 f 来 表示 文件 对 象 ， 这 是 一 种 常见 的 做 法 。 二 是 给 参 
数 encoding 指定 了 值 ， 在 系统 的 默认 编码 与 要 读 取 文件 使 用 的 编 
码 不 一 致 时 ， 必 须 这 样 做 。 


Python 无 法 读 取 不 存在 的 文件 ， 因 此 和 它 引 发 一 个 开 第 : 


Traceback (most recent call last): 
File "alice.py", line 3, in <module> 
with open(filename, encoding="'utf-8') as f: 


FileNotFoundError: [Errno 2] No such file or directory: 'alice.txt' 


上 述 traceback 的 最 后 一 行 报告 了 FileNotFoundError 异常 ， 这 是 

Python 找 不 到 要 打开 的 文件 时 创建 的 异常 。 在 本 例 中 ， 这 个 错误 是 
函数 open() 导致 的 。 因 此 ， 要 处 理 这 个 错误 ， 必 须 将 try 语句 放 

在 包含 open() 的 代码 行 之 前 : 


filename = 'alice.txt' 
try: 


with open(filename, encoding="'utf-8') as f: 
contents = f.read() 


except FileNotFoundError: 
print(f"Sorry, the file {filename} does not exist.") 


在 本 例 中 ，try 代码 块 引发 了 FileNotFoundError 异常 ， 因 此 
Python 找到 与 该 错误 匹配 的 except 代码 块 ， 并 运行 其 中 的 代码 。 
最 终 的 结果 是 显示 一 条 友好 的 错误 消息 ， 而 不 是 traceback: 


Sorry, the file alice.txt does not exist. 


如 果 文 件 不 存在 ， 这 个 程序 就 什么 都 做 不 了 ， 错 误 处 理 代码 也 意义 
不 大 。 下 面 来 扩展 这 个 示例 ， 看 看 在 你 使 用 多 个 文件 时 ， 异 常 处 理 
可 提供 什么 样 的 帮助 。 


10.3.6 “分析 文本 


你 可 以 分 析 包 含 整 本 书 的 文本 文件 。 很 多 经 典 文学 作品 都 是 简单 以 
文本 文件 的 形式 提供 的 ， 因 为 它们 不 受 版 权限 制 。 本 市 使 用 的 文本 
来 日 古 登 堡 计划 ， 该 计划 提供 了 一 系列 不 受 版 权限 制 的 文学 作品 。 
如 琳 你 要 在 编程 项 目 中 使 用 文学 文本 ， 这 是 一 个 很 不 错 的 资源 。 


下 面 来 提取 重 话 《爱丽 丝 漫游 奇 境 记 》 (Alice in Wonderland ) 的 
文本 ， 并 尝试 计 算 它 包含 多 少 个 单词 。 我 们 将 使 用 方法 splLit() ， 
它 能 根据 一 个 字符 串 创建 一 个 单词 列表 。 下 面 是 对 只 包含 童话 
名 "Alice in Wonderland" 的 字符 串 调用 方法 split() 的 结 


>>> title = "Alice in Wonderland" 
>>> title.split() 


['Alice', 'in', 'Wonderland'] 


方法 split() 以 空格 为 分 隔 符 将 字符 串 分 拆 成 多 个 部 分 ， 并 将 这 些 
部 分 都 存储 到 一 个 列表 中 。 结 果 是 一 个 包含 字符 串 中 所 有 单词 的 列 
表 ， 虽 然 有 些 单词 可 能 包含 标点 。 为 计算 《爱丽 丝 漫 游 奇 境 记 》 包 
含 多 少 个 单词 ， 我 们 将 对 整 篇 小 说 调用 split() ， 再 计算 得 到 的 列 
表 包含 多 少 个 元 素 ， 从 而 确定 整 篇 童话 大 致 包含 多 少 个 单词 


filename = "alice.txt' 


try: 
with open(filename, encoding="'utf-8') as f: 
contents = f.read() 
except FileNotFoundError: 
print(f"Sorry, the file {filename} does not exist.") 


else: 
# 计算 该 文件 大 致 包含 多 少 个 单词 。 
words = contents.split() 
num_ words = len(words) 
print(f"The file {filename} has about {num words} words.") 


我 们 将 文件 alice.txt 移 到 了 正确 的 目录 中 ， 让 try 代码 块 能 够 成 功 执 
行 。 在 @ 处 ， 对 变量 contents ( 它 现 在 是 一 个 长 长 的 字符 串 ， 包 


售 音 话 《 爱 丽 丝 漫 游 奇 境 记 》 的 全 部 文本 ) 调用 方法 split() ， 以 
生成 一 个 列表 ， 其 中 包含 这 部 童话 中 的 所 有 单词 。 使 用 len() 来 确 
定 这 个 列表 的 长 度 时 ， 束 能 知道 原始 字符 串 大 致 包 含 多 少 个 单词 了 
( 见 @) 。 在 僵 处 ， 打 印 一 条 消息 ， 指 出 文件 包含 多 少 个 单词 。 这 
些 代码 都 放 在 else 代码 块 中 ， 因 为 仅 当 try 代码 块 成 功 执行 时 才 
执行 它们 。 输 出 指出 了 文件 alice.txt 包 含 多 少 个 单词 : 


The file alice.txt has about 29465 words. 


这 个 数 稍 大 一 点 ， 因 为 使 用 的 文本 文件 包含 出 版 商 提供 的 额外 信 
忠 ， 但 还 是 成 功 估 算出 了 童话 《爱丽 丝 漫 游 奇 境 记 》 的 篇 幅 。 


10.3.7 ”使 用 多 个 文件 
下 面 多 分 析 几 本 书 。 这 此 之 前 ， 先 将 这 个 程序 的 大 部 分 代码 移 到 一 


人 的 函数 中 。 这 样 ， 对 多 本 书 进行 分 析 时 将 


word_count.py 


def count words(filename): 
@ "计算 一 个 文件 大 至 包含 多 少 个 单词 。""" 
try: 
with open(filename, encoding="'utf-8') as ff: 
contents = f.read() 
except FileNotFoundError: 
print(f"Sorry, the file {filename} does not exist.") 
else: 


words = contents.split() 
num words = len(words) 
print(f"The file {filename} has about {num words} words.") 


filename = "alice.txt' 
count words(filename) 


这 些 代 码 大 多 与 原来 一 样 ， 只 是 移 到 了 函数 count_words() 中 ， 
并 增加 了 缩 进 量 。 修 改 程序 的 同时 更 新 注释 是 个 不 错 的 习惯 ， 因 此 


我 们 将 注释 改 成 文档 字符 串 ， 并 稍微 调整 了 一 下 措 套 ( 见 @) 。 


现在 可 以 编写 一 个 简单 的 循环 ， 计 算 要 分 析 的 任何 文本 包含 多 少 个 
单词 了 。 为 此 ， 将 要 分 析 的 文件 的 名 称 存储 在 一 个 列表 中 ， 然 后 对 
列表 中 的 每 个 文件 调用 count_words() 。 我 们 将 尝试 计算 《爱丽 
丝 漫游 奇 境 记 》《 悉 达 多 》 (Siddhartha ) 、《 白 鲸 》 (Moby Dick 
) 和 《小 妇 人 》 (Little Women ) 分 别 包含 多 少 个 单词 ， 它 们 都 不 
受 版 权限 制 。 我 故意 没有 将 siddhartha.txt 放 到 word_count.py 所 在 的 
目录 中 ， 从 而 展示 该 程序 在 文件 不 存在 时 应 对 得 有 多 出 色 : 


def count words(filename): 
--Snip-- 


filenames = ['alice.txt', 'siddhartha.txt', "moby dick.txt', 'little w 


for filename in filenames: 
count words(filename) 


文件 siddhartha.txt 不 存在 ， 但 这 丝 坚 不 影响 该 程序 处 理 其 他 文件 : 


The file alice.txt has about 29465 words. 
Sorry, the file siddhartha.txt does not exist. 
The file moby dick.txt has about 215836 words. 


The file little women.txt has about 189679 words. 


在 本 例 中 ， 使 用 try-except 代码 块 提供 了 两 个 重要 的 优点 : 避免 
用 户 看 到 traceback， 以 及 让 程序 继续 分 析 能 够 找到 的 其 他 文件 。 如 
果 不 捕获 因 找 不 到 siddhartha.txt 而 引发 的 FileNotFoundError 异 

常 ， 用 户 将 看 到 完整 的 traceback， 而 程序 将 在 尝试 分 析 《 悉 达 多 》 
后 停止 运行 。 它 根本 不 会 分 析 《 白 稣 》 和 《小 妇 人 》。 


10.3.8 ”静默 失败 


在 前 一 个 示例 中 ， 我 们 告诉 用 户 有 一 个 文件 找 不 到 。 但 并 非 每 次 捕 
获 到 异常 都 需要 告诉 用 户 ， 有 时 候 你 希望 程序 在 发 生 异 常 时 保持 静 
默 ， 就 像 什么 都 没有 发 生 一 样 继续 运行 。 要 让 程序 静默 失败 ， 可 像 
通常 那样 编写 try 代码 块 ， 但 在 except 代码 块 中 明确 地 告诉 


Python 什么 都 不 要 做 。Python 有 一 个 pass 语句 ， 可 用 于 让 Python 在 
代码 块 中 什么 都 不 要 做 : 


def count words(filename): 
""" 计 算 一 个 文件 大 致 包含 多 少 个 单词 。""" 
try: 
--Snip-- 
except FileNotFoundError: 


pass 
else: 


--Snip-- 


filenames = [ "alice.txt'， 'siddhartha.txt', 'moby dick.txt', 'little 
for filename in filenames: 
count words(filename) 


相 比 于 前 一 个 程序 ， 这 个 程序 唯一 的 不 同 之 处 是 @ 处 的 pass 语 

人 句 。 现 在 ， 出 现 FileNotFoundError 异常 时 ， 将 执行 except 代码 
块 中 的 代码 ， 但 什么 都 不 会 发 生 。 这 种 错误 发 生 时 ， 不 会 出 现 
traceback， 也 没有 任何 输出 。 用 户 将 看 到 存在 的 每 个 文件 包含 多 少 
个 单词 ， 但 没有 任何 迹象 表明 有 一 个 文件 未 找到 : 


The file alice.txt has about 29465 words. 
The file moby dick.txt has about 215836 words . 


The file little _ women.txt has about 189679 words . 


pass 语句 还 充当 了 占 位 符 ， 提 醒 你 在 程序 的 某 个 地 方 什么 都 没有 
做 ， 并 且 以 后 也 许 要 在 这 里 做 些 什么 。 例 如 ， 在 这 个 程序 中 ， 我 们 
可 能 决定 将 找 不 到 的 文件 的 名 称 写 入 文件 missing_files.txt 中 。 用 户 
看 不 到 这 个 文件 ， 但 我 们 可 以 读 取 它 ， 进 而 处 理 所 有 找 不 到 文件 的 


问题 。 
10.3.9 ”决定 报告 哪些 错误 
该 在 什么 情况 下 向 用 户 报告 错误 ?又 该 在 什么 情况 下 静默 失败 呢 ? 


如 果 用 户 知道 要 分 析 哪 些 文件 ， 他 们 可 能 希望 在 有 文件 却 没有 分 析 
时 出 现 一 条 消息 来 告知 原因 。 如 果 用 户 只 想 看 到 结果 ， 并 不 知道 要 


分 析 哪 些 文 件 ， 可 能 就 无 顷 在 有 些 文 件 不 存在 时 告知 他 们 。 回 用 户 
显示 他 不 想 看 到 的 信息 可 能 会 降低 程序 的 可 用 性 。Python 的 错误 处 
理 结构 让 你 能 够 细致 地 控制 与 用 尸 分 享 错误 信息 的 程度 ， 要 分 撞 多 
少 信息 由 你 决定 。 


编写 得 很 好 且 经 过 详尽 测试 的 代码 不 容易 出 现 内 部 错误 ， 如 语法 或 
逻辑 错误 ， 但 只 要 程序 依赖 于 外 部 因素 ， 如 用 户 输入 、 存 在 指定 的 
文件 、 有 网 络 链接 ， 就 有 可 能 出 现 异常 。 和 凭借 经 验 可 判断 该 在 程序 
I 以 及 出 现 错误 时 该 向 用 户 提 供 多 少 相 


动手 试 一 斌 


练习 10-6: 加 法 运算 提示 用 户 提供 数值 输入 时 ， 常 出 现 的 

一 个 问题 是 ， 用 户 提供 的 是 文本 而 不 是 数 。 在 此 情况 下 ， 当 你 
尝试 将 输入 转换 为 整数 时 ， 将 引发 ValueError 异常 。 编 写 一 
个 程序 ， 提 示 用 户 输入 两 个 数 ， 再 将 其 相 加 并 打印 结果 。 在 用 
户 输入 的 任何 一 个 值 不 是 数 时 都 捕获 ValueError 异常 ， 并 打 
印 一 条 友好 的 错误 消息 。 对 你 编写 的 程序 进行 测试 : 先 输入 两 
个 数 ， 再 输入 一 些 文本 而 不 是 数 。 


练习 10-7: 加 法 计算 器 ”将 为 完成 练习 10-6 而 编写 的 代码 放 在 
一 个 while 循环 中 ， 让 用 户 犯 错 ( 输 入 的 是 文本 而 不 是 数 ) 后 
能 够 继续 输入 数 。 


练习 10-8: 猎 和 狗 创建 文件 cats.txt 和 dogs.txt， 在 第 一 个 文 
件 中 至 少 存储 三 只 猫 的 名 字 ， 在 第 二 个 文件 中 至 少 存储 三 条 狗 
的 名 字 。 编 写 一 个 程序 ， 尝 试 读 取 这 些 文件 ， 并 将 其 内 容 打 印 
到 屏幕 上 。 将 这 些 代 码 放 在 一 个 try-except 代码 块 中 ， 以 便 
在 文件 不 存在 时 捕获 FileNotFound 错误 ， 并 显示 一 条 友好 的 
消息 。 将 任意 一 个 文件 移 到 另 一 个 地 方 ， 并 确认 except 代码 
块 中 的 代码 将 正确 执行 。 


练习 10-9: 静默 的 猫 和 狗 ”修改 你 在 练习 10-8 中 编写 的 
except 代码 块 ， 让 程序 在 任意 文件 不 存在 时 静默 失败 。 


练习 10-10: 常见 单词 ”访问 古 登 保 计 划 ， 找 一 些 你 想 分 析 的 
图 书 。 下 载 这 些 作 品 的 文本 文件 或 将 浏览 器 中 的 原始 文本 复制 


到 文本 文件 中 。 


可 以 使 用 方法 count() 来 确定 特定 的 单词 或 短语 在 字符 串 中 出 
现 了 多 少 次 。 例 如 ， 下 面 的 代码 计算 "row' 在 一 个 字符 串 中 出 
现 了 多 少 次 : 


>>> line = "Row, row, row your boat" 
>>> line.count('row') 

2 

>>> line.lower().count('row') 


3 


请 注意 ， 通 过 使 用 lower() 将 字符 串 转换 为 小 写 ， 可 捕捉 要 查 
找 单词 的 所 有 格式 ， 而 不 管 其 大 小 写 如 何 。 


编写 一 个 程序 ， 它 读 取 你 在 古 登 堡 计划 中 获取 的 文件 ， 并 计算 
单词 'the' 在 每 个 文件 中 分 别 出 现 了 多 少 次 。 这 里 计算 得 到 的 
结果 并 不 准确 ， 因 为 将 诸如 'then' 和 'there' 等 单词 也 计算 
在 内 了 。 请 尝试 计算 'the ' (包含 空格 〉 出现 的 次 数 ， 看 看 
结果 相差 多 少 。 


10.4 ”存储 数据 


很 多 程序 都 要 求 用 户 输 入 某 种 信息 ， 如 让 用 户 存 储 游戏 首选 项 或 提 
供 要 可 视 化 的 数据 。 不 管 关注 点 是 什么 ， 程 序 都 把 用 户 提 供 的 信息 
存储 在 列表 和 字典 等 数据 结构 中 。 用 户 关 闭 程 序 时 ， 几 乎 总 是 要 保 
| 一 种 简单 的 方式 是 使 用 模块 json 来 存储 数 


模块 json 让 你 能 够 将 简单 的 Python 数据 结构 转 储 到 文件 中 ， 并 在 
程序 再 次 运行 时 加 载 该 文件 中 的 数据 。 你 还 可 以 使 用 json 在 
Python 程序 之 间 分 享 数 据 。 更 重要 的 是 ，JSON 数 据 格式 并 非 Python 
专用 的 ， 这 让 你 能 够 将 以 JSON 格 式 存储 的 数据 与 使 用 其 他 编程 语 
言 的 人 分 享 。 这 是 一 种 轻便 而 有 用 的 格式 ， 也 易于 学 习 。 


注意 ”JSON (JavaScript Object Notation ) 格式 最 初 是 为 
JavaScript 开 发 的 ， 但 随后 成 了 一 种 种 见 格式 ， 被 包括 Python 在 
内 的 众多 语言 采用 。 


10.4.1 使 用 json .dump() 和 json.1load() 


我 们 来 编写 一 个 存储 一 组 数 的 简短 程序 ， 再 编写 一 个 将 这 些 数 读 取 
到 内 存 中 的 程序 。 第 一 个 程序 将 使 用 json .dump() 来 存储 这 组 
数 ， 而 第 二 个 程序 将 使 用 json .load() 。 


函数 json .dump() 接受 两 个 实 参 : 要 存储 的 数据 ， 以 及 可 用 于 存 
下 面 演示 了 如 何 使 用 json.dump() 来 存储 数 
字 列 表 : 


number_writer.py 


import json 


numbers = [2，3，5，7，11，13] 


@ filename = 'numbers.json’ 
@ with open(filename, 'w') as f: 
日 json.dump(numbers, f) 


[L | 


先导 入 模块 json ， 再 创建 一 个 数字 列表 。 在 @ 处 ， 指 定 了 要 将 该 
数字 列表 存储 到 哪个 文件 中 。 通 常 使 用 文件 扩展 名 .json 来 指出 文件 
存储 的 数据 为 JSON 格 式 。 接 下 来 ， 以 写 入 模式 打开 这 个 文件 ， 让 
json 能 够 将 数据 写 入 其 中 ( 见 @) 。 在 全 处 ， 使 用 函 
数 json.dump() 将 数字 列表 存储 到 文件 numbers.json 中 。 


这 个 程序 没有 和 输出， 但 可 以 打开 文件 numbers.json 来 看 看 内 容 。 数 
据 的 存储 格式 与 Python 中 一 样 : 


[2，3，5，7，11，13] 


下 面 再 编写 一 个 程序 ， 使 用 json .1oad() 将 列表 读 取 到 内 存 中 : 


number_reader.py 


import json 


@ filename = 'numbers.json’' 
@ With open(filename) as f: 


© numbers = json.1load(f) 


print(numbers) 


在 @ 处 ， 确 保 读 取 的 是 前 面 写 入 的 文件 。 这 次 以 读 取 方式 打开 该 文 
件 ， 因 为 Python 只 需要 读 取 它 ( 见 人 @) 。 在 @ 处 ， 使 用 函 

数 json.1o0ad() 加 载 存 储 在 numbers.json 中 的 信息 ， 并 将 其 赋 给 变 
量 numbers 。 最 后 ， 打 印 恢复 的 数字 列表 ， 看 看 是 个 后 
number_writer.py 中 创建 的 数字 列表 相同 : 


[2，3，5，7，11，13] 


这 是 一 种 在 程序 之 间 共 享 数 据 的 简单 方式 。 


10.4.2 保存 和 读 取 用 户 生 成 的 数据 


使 用 json 保存 用 户 生 成 的 数据 大 有 神 蔓 ， 因 为 如 果 不 以 茶 种 方式 
存储 ， 用 户 的 信息 会 在 程序 停止 运行 时 丢失 。 下 面 来 看 一 个 这 样 的 
例子 : 提示 用 户 首 次 运行 程序 时 输入 目 己 的 名 字 ， 并 在 再 次 运行 程 
序 时 记 住 他 。 


先 来 存储 用 户 的 名 字 : 


remember_me.py 


import json 


@ username = input("What is your name? ") 


filename = "username.json' 
with open(filename, 'w') as f: 
@ json.dump(username, f) 
@ print(f"We'll remember you when you come back, {username}!") 


在 @@ 处 ， 提 示 输 入 用 户 名 并 将 其 赋 给 一 个 变量 。 接 下 来 ， 调 

用 json.dump() ， 并 将 用 户 名 和 一 个 文件 对 象 传递 给 它 ， 从 而 将 
用 户 名 存储 到 文件 中 ( 见 @) 。 然 后 ， 打 印 一 条 消息 ， 指 出 存储 了 
用 户 输入 的 信息 ( 见 @) : 


What is your name? Eric 
We'll remember you when you come back, Eric! 


现在 再 编写 一 个 程序 ， 同 已 存储 了 名 字 的 用 户 发 出 问候 : 


greet_ user.py 


import json 


filename = "username.json' 


with open(filename) as f: 


@ username = json.1load(f) 
@ print(f"Welcome back, {username}!") 


在 @@ 处 ， 使 用 json.1load() 将 存储 在 username.json 中 的 信息 读 取 到 
i 
) : 


Welcome back，Ericl 


需要 将 这 两 个 程序 合并 到 一 个 程序 (remember_me.py) 中 。 这 个 程 
序 运行 时 ， 将 尝试 从 文件 username.json 中 获取 用 户 名 。 因 此 ， 首 先 
编写 一 个 答 试 恢复 用 户 名 的 try 代码 块 。 如 果 这 个 文件 不 存在 ， 束 
在 except 代码 块 中 提示 用 户 输入 用 户 名 ， 并 将 其 存储 到 
username.json 中 ， 以 便 程 序 再 次 运行 时 能 够 获取 : 


remember_me.py 


import json 
# 如 果 以 前 存储 了 用 户 名 ， 就 加 载 它 。 
# 否则 ， 提 示 用 户 输入 用 户 名 并 存储 它 。 
filename = "username.json' 
try: 
with open(filename) as f: 
@ username = json.1load(f) 
©@ except FileNotFoundError: 


@ username = input("What is your name? ") 
9 with open(filename, 'w') as f: 
json.dump(username, f) 
print(f"We'll remember you when you come back, {username}!") 


else: 
print(f"Welcome back, {username}!") 


这 里 没有 任何 新 代码 ， 只 是 将 前 两 个 示例 的 代码 合并 到 了 一 个 程序 
中 。 在 和 处 ， 沦 试 打开 文件 username.json。 如 果 该 文件 存在 ， 束 将 
其 中 的 用 户 名 读 取 到 内 存 中 《〈 见 仿 ) ， 再 执行 else 代码 块 ， 打 印 
一 条 欢迎 用 户 回来 的 消息 。 用 户 首次 运行 该 程序 时 ， 文 件 


username.json 不 存在 ， 将 引发 FileNotFoundError 异常 〈 见 
全 ) . 因此 Python 将 执行 except 代码 块 ， 提 示 用 户 输 入 用 户 名 
( 见 @) ， 再 使 用 json .dump() 存储 该 用 户 名 并 打印 一 句 问候 语 
( 见 @) 。 


无 论 执行 的 是 except 还 是 else 代码 块 ， 都 将 显示 用 户 名 和 合适 的 
问候 语 。 如 果 这 个 程序 是 首次 运行 ， 输 出 将 如 下 : 


What is your name? Eric 
We'll remember you when you come back, Eric! 


人 否则， 输出 将 如 下 : 


Welcome back, Eric! 


这 是 程序 之 前 至 少 运 行 了 一 次 时 的 输出 。 
10.4.3 ” 重 构 


你 经 名 会 遇 到 这 样 的 情况 : 代码 能 够 正确 地 运行 ， 但 通过 将 其 划分 
为 一 系列 完成 具体 工作 的 函数 ， 还 可 以 改进 。 这 样 的 过 程 称 为 重 构 
。 重 构 让 代码 更 清晰 、 更 易于 理解 、 更 容易 扩展 。 


要 重 构 remember_me.py， 可 将 其 大 部 分 逻辑 放 到 一 个 或 多 个 函数 
中 。remember_me.py 的 重点 是 问候 用 户 ， 因 此 将 其 所 有 代码 都 放 到 
一 个 名 为 greet_user() 的 函数 中 : 


remember_me.py 


import json 
def greet user(): 


@ "问候 用 户 ， 并 指出 其 名 字 。""" 
filename = "Username.json' 
try: 
with open(filename) as f: 
username = json.1load(f) 


except FileNotFoundError: 
username = input("What is your name? ") 
with open(filename, 'w') as ff: 
json.dump(username, f) 


print(f"We'll remember you when you come back, {username 
else: 


print(f"Welcome back, {username}!") 


greet_user() 


考虑 到 现在 使 用 了 一 个 函数 ， 我 们 删除 原 注释 ， 转 而 使 用 一 个 文档 


Ey 


字符 


串 来 指出 程序 的 作用 ( 见 @)〉 。 这 个 程序 更 加 清晰 ， 但 函 


数 greet_user() 所 做 的 不 仅仅 是 问候 用 户 ， 还 在 存储 了 用 户 名 时 


获取 它 、 在 没有 存储 用 户 名 时 提示 用 户 输 入 。 


下 面 来 重 构 greet_user()， 减 少 其 任务 。 为 此 ， 首 先 将 获取 已 存 
储 用 户 名 的 代码 移 到 另 一 个 函数 中 : 


import json 


def get_stored_username() : 


@ 


def 


"" "如 果 存 储 了 用 户 名 ， 就 获取 它 。""" 
filename = "Username.json' 
try: 

with open(filename) as f: 

username = json.1load(f) 

except FileNotFoundError: 

return None 
else: 

return username 


greet user(): 
"" "问候 用 户 ， 并 指出 其 名 字 。""" 
username = get_stored username() 
if username: 
print(f"Welcome back, {username}!") 
else: 
username = input("What is your name? ") 
filename = "Username.json' 
with open(filename, 'w') as ff: 
json.dump(username, f) 
print(f"We'll remember you when you come back, {username 


greet_user() 


新 增 的 函数 get_stored_username() 日 标明 确 ，@ 处 的 文档 字符 
串 指出 了 这 一 点 。 如 果 存 储 了 用 户 名 ， 该 函数 就 获取 并 返回 它 ， 如 
果 文 件 username.json 不 存在 ， 该 函数 就 返回 None 〈 见 四) 。 这 是 一 
种 不 错 的 做 法 : 函数 要 么 返回 预期 的 值 ， 要 么 返回 None 。 这 让 我 
们 能 够 使 用 函数 的 返回 值 做 简单 的 测试 。 在 全 处 ， 如 果 成 功 地 获取 
就 打印 一 条 欢迎 用 户 回 来 的 消息 ， 否 则 提示 用 户 输入 用 
性 名 。 


还 需要 重 构 greet_user() 中 的 男 一 个 代码 块 ， 将 没有 存储 用 户 名 
时 提示 用 户 输 入 的 代码 放 在 一 个 独立 的 函数 中 : 


import json 


def get_ stored username(): 
""" 如 果 存 储 了 用 户 名 ， 就 获取 它 。""" 


--Snip-- 


get new username(): 

""" 提 示 用 户 输入 用 户 名 。""" 

username = input("What is your name? ") 

filename = "username.json' 

with open(filename, 'w') as f: 
json.dump(username, f) 

return username 


greet user(): 
"" "问候 用 户 ， 并 指出 其 名 字 。""" 
username = get_stored username() 
if username: 
print(f"Welcome back, {username}!") 
else: 
username = get new username() 
print(f"We'll remember you when you come back, {username}!") 


greet_user() 


在 remember_me.py 的 这 个 最 终 版 本 中 ， 每 个 函数 都 执行 单一 而 清晰 


的 任务 。 我 们 调用 greet_user() ， 它 打印 一 条 合适 的 消息 : 要 么 
欢迎 老 用 户 回 来 ， 要 么 问候 新 用 户 。 为 此 ， 它 首先 调 

用 get_stored_username() ， 该 函数 只 负责 获取 已 存储 的 用 户 名 
(如 果 存 储 了 的 话 ) 。 最 后 在 必要 时 调用 get_new_username() ， 
该 函数 只 负责 获取 并 存储 新 用 户 的 用 户 名 。 要 编写 出 清晰 而 易于 维 
护 和 扩展 的 代码 ， 这 种 划分 必 不 可 少 。 


动手 试 一 斌 
练习 10-11: 喜欢 的 数 ”编写 一 个 程序 ， 提 示 用 户 输入 喜欢 的 


数 ， 并 使 用 json.dump( ) 将 这 个 数 存储 到 文件 中 。 再 编写 一 
个 程序 ， 从 文件 中 读 取 这 个 值 ， 并 打印 如 下 所 示 的 消息 。 


I know your favorite number! It's 


练习 10-12: 记 住 喜欢 的 数 ”将 练习 10-11 中 的 程序 合 二 为 一 。 
如 果 存 储 了 用 户 喜 欢 的 数 ， 就 向 用 户 显示 它 ， 否 则 提示 用 户 输 
入 喜欢 的 数 并 将 其 存储 到 文件 中 。 运 行 这 个 程序 两 次 ， 看 看 它 
能 否 像 预期 的 那样 工作 。 


练习 10-13: 验证 用 户 ”最 后 一 个 remember_me.py 版 本 假设 用 
户 要 么 已 输入 用 户 名 ， 要 么 是 首次 运行 该 程序 。 我 们 应 该 修改 
这 个 程序 ， 以 防 当前 用 户 并 非 上 次 运行 该 程序 的 用 户 。 

为 此 ， 在 greet_user() 中 打印 欢迎 用 户 回来 的 消息 前 ， 询 问 


他 用 户 名 是 否 正确 。 如 果 不 对 ， 就 调用 get_new_username() 
让 用 户 输入 正确 的 用 户 名 。 


10.5 ”小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 文件 ， 如 何 一 次 性 读 取 整 个 文件 ， 
以 及 如 何以 每 次 一 行 的 方式 读 取 文件 的 内 容 ; 如 何 写 入 文件 ， 以 及 
如 何 将 文本 附加 到 文件 末尾 ;什么 是 异常 以 及 如 何 处 理 程序 可 能 引 
发 的 异常 ， 如 何 存储 Python 数 据 结构 ， 以 保存 用 户 提 供 的 信息 ， 避 
免 用 户 每 次 运行 程序 时 都 需要 重新 提供 。 


在 第 11 章 中 ， 你 将 学 习 高 效 的 代码 测试 方式 。 这 可 帮助 你 确定 代码 
正确 无 误 ， 以 及 发 现 扩展 现 有 程序 时 可 能 引入 的 pug。 


第 11 章 测试 代码 


编写 函数 或 类 时 ， 还 可 为 其 编写 测试 。 通 过 测 
试 ， 可 确定 代码 面 对 各 种 输入 都 能 够 按 要 求 的 那样 工作 。 测 试 
让 你 深信 ， 即 便 有 更 多 人 使 用 你 的 程序 ， 它 也 能 正确 地 工作 。 
在 程序 中 添加 新 代码 时 ， 也 可 以 对 其 进行 测试 ， 确 认 不 会 破坏 
程序 既 有 的 行为 。 程 序 员 都 会 犯错 ， 因 此 每 个 程序 员 都 必须 经 
各 测试 其 代码 ， 在 用 户 发 现 问题 前 找 出 它们 。 


在 本 章 中 ， 你 将 学 习 如 何 使 用 Python 模块 unittest 中 的 工具 
来 测试 代码 ， 还 将 学 习 编 写 测 试用 例 ， 核 实 一 系列 输入 都 将 得 
到 预期 的 输出 。 你 将 看 到 测试 通过 了 是 什么 样子 ， 测 试 未 通过 
又 是 什么 样子 ， 还 将 知道 测试 未 通过 如 何 有 助 于 改进 代码 。 你 
0 

试 。 


11.1 测试 函数 


要 学 习 测 试 ， 必 须 有 要 测试 的 代码 。 下 面 是 一 个 简单 的 函数 ， 它 接 
受 名 和 姓 并 返回 整洁 的 姓名 : 


name_function.py 


def get_ formatted name (finst, last): 
"生成 整洁 的 姓名 。 
full name = f"{first} {last}" 


return full name.title() 


函数 get_ Re _name( ) 将 名 和 姓 合 并 成 姓名 : 在 名 和 姓 之 
间 加 上 一 个 空格 并 将 其 首 字 母 大 写 ， 再 返回 结果 。 为 核实 

| 像 期 望 的 那样 工作 ， 我 们 来 编写 一 个 使 
0 


names.py 


from name_function import get formatted name 


print("Enter 'q' at any time to quit.") 
while True: 
first = input("\nplease give me a first name: ") 
if first == 'q"': 
break 
last = input("Please give me a last name: ") 
if last == 'q': 
break 


formatted name = get formatted name(first, last) 
print(f"\tNeatly formatted name: {formatted name}.") 


这 个 程序 从 name_function.py 中 导入 get_formatted_name() 。 用 
户 可 输入 一 系列 名 和 姓 ， 并 看 到 格式 整洁 的 姓名 : 


Enter 'q' at any time to quit. 


Please give me a first name: janis 
Please give me a last name: joplin 
Neatly formatted name: Janis Joplin. 


Please give me a first name: bob 
Please give me a last name: dylan 
Neatly formatted name: Bob Dylan. 


Please give me a first name: 9q 


从 上 述 输出 可 知 ， 合 并 得 到 的 姓名 正确 无 误 。 现 在 假设 要 修 

改 get_formatted_name() ， 使 其 还 能 够 处 理 中 间 名 。 这 样 做 
时 ， 要 确保 不 破坏 这 个 函数 处 理 只 含有 名 和 姓 的 姓名 的 方式 。 为 
此 ， 可 在 每 次 修改 get_formatted_name() 后 都 进行 测试 : 运行 
程序 names.py， 并 输入 像 Janis Joplin 这 样 的 姓名 。 不 过 这 太 烦 琐 

了 。 所 季 Python 提 供 了 一 种 自动 测试 函数 输出 的 高 效 方式 。 倘 知 对 
get_formatted_name() 进行 自动 测试 ， 就 能 始终 确信 当 提 供 测 
试 过 的 姓名 时 ， 该 函数 都 能 正确 工作 。 


11.1.1 单元 测试 和 测试 用 例 


Python 标准 库 中 的 模块 unittest 提供 了 代码 测试 工具 。 单 元 测试 
用 于 核实 函数 的 某 个 方面 没有 问题 。 测 试用 例 是 一 组 单元 测试 ， 
它们 一 道 核实 函数 在 各 种 情形 下 的 行为 都 符合 要 求 。 良 好 的 测试 用 
例 考虑 到 了 函数 可 能 收 到 的 各 种 输入 ， 包 含 针 对 所 有 这 些 情 形 的 测 
试 。 全 禾 盖 的 测试 用 例 包含 一 整套 单元 测试 ， 涵 盖 了 各 种 可 能 的 
函数 使 用 方式 。 对 于 大 型 项 目 ， 要 进行 全 履 盖 测试 可 能 很 难 。 通 
常 ， 最 初 只 要 针对 代码 的 重要 行为 编写 测试 即 可 ， 等 项 目 被 广泛 使 
用 时 再 考虑 全 履 盖 。 

11.1.2 可 通过 的 测试 

你 需要 一 段 时 间 才 能 习惯 创建 测试 用 例 的 语法 ， 但 创建 测试 用 例 之 
后 ， 再 添加 针对 函数 的 单元 测试 就 很 简单 了 。 要 为 函数 编写 测试 用 
例 ， 可 先导 入 模块 unittest 和 要 测试 的 函数 ， 再 创建 一 个 继 

承 unittest.TestCase 的 类 ， 并 编写 一 系列 方法 对 函数 行为 的 不 


同方 面 进行 测试 。 
下 面 的 测试 用 例 只 包含 一 个 方法 ， 它 检查 也 
数 get_formatted_name() 在 给 定名 和 姓 时 能 否 正确 工作 : 


test_ name_function.py 


import unittest 
from name_ function import get formatted name 


@ class NamesTestCase(unittest.TestCase): 
"测试 name_function.py。""" 


def test first last name(self): 


能 够 正确 地 处 理 像 Janis Joplin 这 样 的 姓名 吗 ?""" 
formatted name = get formatted name('janis', 'joplin') 
self.assertEqual(formatted name, 'Janis Joplin') 


_name == "main 
unittest.main() 


首先 ， 导 入 了 模块 unittest 和 要 测试 的 函 

数 get_formatted_name() 。 在 @@ 处 ,创建 了 一 个 名 

为 NamesTestCase 的 类 ， 用 于 包含 一 系列 针对 
get_formatted_name() 的 单元 测试 。 这 个 类 可 以 随意 命名 ， 但 
最 好 让 它 看 起 来 与 要 测试 的 函数 相关 并 包含 Test 字样 。 0 
须 继承 unittest.TestCase 类 ， 这 样 Python 才 知道 如 何 运 行 你 编 
写 的 测试 。 


NamesTestCase 只 包含 一 个 方法 ， 用 于 测试 
get_formatted_name() 的 一 个 方面 。 将 该 方法 命名 

为 test_ first 1ast _name() ， 因为 要 核实 的 是 只 有 名 和 姓 的 姓 
名 能 否 被 正确 格式 化 。 运 行 test_name_function.py 时 ， 所 有 以 test_ 
打头 的 方法 都 将 自动 运行 。 在 这 个 方 法 中 ， 调 用 了 要 测试 的 函数 。 
在 本 例 中 ， 使 用 实 参 'janis' 和 'joplin' 调 

用 get_formatted_name() ， 并 将 结果 赋 给 变量 formatted_name 
( 见 @) 。 


在 全 处 ， 使 用 了 unittest 类 最 有 用 的 功能 之 一 : 断言 方法 。 上 断言 


方法 核实 得 到 的 结果 是 否 与 期 望 的 结果 一 致 。 在 这 里 ， 我 们 知 
道 get_formatted_name() 应 返回 名 和 姓 首 字母 大 写 且 之 间 有 一 
个 空格 的 姓名 ， 因 此 期 望 formatted_name 的 值 为 Janis Joplin 
。 为 检查 是 否 确实 如 此 ， 我 们 调用 unittest 的 方法 
assertEqual() ， 并 回 它 传递 formatted_name 和 'Janis 
Joplin' 。 代 码 行 


self.assertEqual(formatted name, 'Janis Joplin') 


的 意思 是 :“ 将 formatted_name 的 值 与 字符 串 'Janis Joplin' 
比较 。 如 果 它 们 相等 ， 那 么 万 事 大 吉 ; 如 果 它 们 不 相等 ， 束 告诉 我 


一 声 ! ?? 


我 们 将 直接 运行 这 个 文件 ， 但 需要 指出 的 是 ， 很 多 测试 框架 都 会 先 
导入 测试 文件 再 运行 。 导 入 文件 时 ， 解 释 器 将 在 导入 的 同时 执行 
它 。@ 处 的 if 代码 块 检查 特殊 变量 _name _ ， 这 个 变量 是 在 程序 
执行 时 设置 的 。 如 果 这 个 文件 作为 主 程序 执行 ， 变 量 _name_ 将 
被 设置 为 '_ main_'" 。 在 这 里 ， 调 用 unittest.main() 来 运行 
测试 用 例 。 如 果 这 个 文件 被 测试 框架 导入 ， 变 量 _name__ 的 值 将 
不 是 '_ main_“" ， 因 此 不 会 调用 unittest.main() 。 


运行 test_name_function.py 时 ， 得 到 的 输出 如 下 : 


Ran 1 test in 68.6060s 


OK 


第 一 行 的 句点 表明 有 一 个 测试 通过 了 。 接 下 来 的 一 行 指出 Python 运 
行 了 一 个 测试 ， 消 耗 的 时 间 不 到 0.001 秒 。 最 后 的 Ok 表明 该 测试 用 
例 中 的 所 有 单元 测试 都 通过 了 。 


上 述 输出 表明 ， 给 定 包 含 名 和 姓 的 姓名 时 ， 也 | 
数 get_formatted_name() 总 是 能 正确 地 处 理 。 修 


改 get_formatted_name() 后 ， 可 再 次 运行 这 个 测试 用 例 。 如 果 
它 通 过 了 ， 就 表明 给 定 Janis Joplin 这 样 的 姓名 时 ， 该 函数 依然 能 够 
正确 地 处 理 。 


11.1.3 未 通过 的 测试 

测试 未 通过 时 结果 是 什么 样 的 呢 ? 我 们 来 修 

改 get_formatted_name() ， 使 其 能 够 处 理 中 间 名 ， 但 同时 故意 
让 该 函数 无 法 正确 处 理 像 Janis 和 文 样 只 有 名 和 姓 的 姓名 。 


下 面 是 函数 get_formatted_name() 的 新 版 本 ， 它 要 求 通过 一 个 
实 参 指定 中 间 名 : 


name_function.py 


def get_ formatted anett LAS middle, last): 
"生成 整洁 的 姓名 。 
full name = f"{first} {middle} {last}" 


return full name.title() 


这 个 版 本 应 该 能 够 正确 处 理 包 含 中 间 名 的 姓名 ， 
时 ， 我 们 发 现 它 不 再 能 正确 处 理 只 有 名 和 姓 的 姓名 。 运行 程序 
test_name_function.py 时 ， 输 出 如 下 : 


@ ERROR: test first last name (_ main _ 


@ Traceback (most recent call last): 
File "test name function.py", line 8, in test first last name 
formatted name = get formatted name('janis', 'joplin') 


TypeError: get formatted name() missing 1 required positional argume 


@ Ran 1 test in 606.6060s 


@ FAILED (errors=1) 


里 面包 含 很 多 信息 ， 因 为 测试 未 通过 时 ， 需 要 让 你 知道 的 事情 可 能 
有 很 多 。 第 一 行 输出 只 有 一 个 字母 E ( 见 @) ， 指 出 测试 用 例 中 有 
一 个 单元 测试 导致 了 错误 。 接 下 来 ， 我 们 看 到 NamesTestCase 中 
的 test_first_last_name() 导致 了 错误 〈 见 多 ) 。 测 试用 例 包 
含 众 多 单元 测试 时 ， 知 道 哪 个 测试 未 通过 至 关 重 要 。 在 全 处 ， 我 们 
看 到 了 一 个 标准 的 traceback， 指 出 函数 调用 get_formatted_name 
('janis'，'joplin') 有 问题 ， 因 为 缺少 一 个 必 不 可 少 的 位 置 实 


傅 。 


我 们 还 看 到 运行 了 一 个 单元 测试 ( 见 例 ) 。 最 后 是 一 条 消息 ， 指 出 
整个 测试 用 例 未 通过 ， 因 为 运行 该 测试 用 例 时 发 生 了 一 个 错误 ( 见 
加 ) 。 这 条 消息 位 于 输出 末尾 ， 让 你 一 眼 就 能 看 到 。 你 可 不 希望 为 
获悉 有 多 少 测 试 未 通过 而 翻阅 长 长 的 输出 。 


11.1.4 测试 未 通过 时 怎么 办 


测试 未 通过 时 怎么 办 呢 ?” 如 果 你 检查 的 条 件 没 错 ， 测 试 通过 意味 着 
函数 的 行为 是 对 的 ， 而 测试 未 通过 意味 独 编 写 的 新 代码 有 错 。 
此 ， 训 试 未 通过 时 ， 不 要 修改 测试 ， 而 应 修复 导致 汕 试 不 能 通过 的 
| 函数 所 做 的 修改 ， 找 出 导致 函数 行为 不 符合 预期 
J 修改 。 


在 本 例 中 ，get_formatted_name() 以 前 只 需要 名 和 姓 两 个 实 
参 ， 但 现在 要 求 提 供 名 、 中 间 名 和 姓 。 新 增 的 中 间 名 参数 是 必 不 可 
少 的 ， 这 导致 get_formatted_name( ) 的 行为 不 符合 预期 。 就 这 
里 而 言 ， 最 佳 的 选择 是 让 中 间 名 变 为 可 选 的 。 这 样 做 后 ， 使 用 类 似 
于 Janis Joplin 的 姓名 进行 测试 时 ， 测 试 就 又 能 通过 了 ， 而 且 也 可 以 
接受 中 间 名 。 下 面 来 修改 get_formatted_name() ， 将 中 间 名 设 
置 为 可 选 的 ， 然 后 再 次 运行 这 个 测试 用 例 。 如 果 通 过 了 ， 就 接着 确 
认 该 函数 能 够 妥善 地 处 理 中 间 名 。 

要 将 中 间 名 设置 为 可 选 的 ， 可 在 函数 定义 中 将 形 参 middle 移 到 形 


参 列 表 末 尾 ， 并 将 其 默认 值 指定 为 一 个 空 字 符 串 。 还 需要 添加 一 
个 if 测试 ， 以 便 根 据 是 否 提 供 了 中 间 名 相应 地 创建 姓名 : 


name_function.py 


def get formatted name(first, last, middle=""'): 


""" 生 成 整洁 的 姓名 。""" 


if middle: 

full name = f"{first} {middle} {last}" 
else: 

full name = f"{first} {last}" 
return full name.title() 


在 get_formatted_name() 的 这 个 新 版 本 中 ， 中 间 名 是 可 选 的 。 
如 采 回 该 函数 传递 了 中 间 名 ， 姓 名 将 包含 名 、 中 间 名 和 姓 ， 否 则 姓 
名 将 只 包含 名 和 姓 。 现 在 ， 对 于 两 种 不 同 的 姓名 ， 这 个 函数 都 应 该 
能 够 正确 地 处 理 。 为 确定 这 个 函数 依然 能 够 正确 处 理 像 Janis Joplin 
这 样 的 姓名 ， 我 们 再 次 运行 test_name_function.py: 


Ran 1 test in 6.60606s 


OK 


现在 ， 测 试用 例 通 过 了 。 太 好 了 ， 这 意味 者 这 个 函数 又 能 正确 处 理 
像 Janis Joplin 这 样 的 姓名 了 ， 而 且 我 们 无 须 手 工 测 试 这 个 函数 。 这 
个 函数 之 所 以 很 容易 修复 ， 是 因为 未 通过 的 测试 让 我 们 得 知 新 代码 
破坏 了 函数 原来 的 行为 。 


11.1.5 ”添加 新 测试 
确定 get_formatted_name() 又 能 正确 处 理 简 单 的 姓名 后 ， 我 们 


再 编写 一 个 测试 ， 用 于 测试 包含 中 间 名 的 姓名 。 为 此 ， 
在 NamesTestCase 类 中 再 添加 一 个 方法 : 


test_ name_function.py 


--Snip-- 
class NamesTestCase(unittest.TestCase): 
"" "测试 name_function.py。""" 


def test first last name(self): 


--Snip-- 


def test first last middle name(self): 
"" 能 够 正确 地 处 理 像 NWolfgang Amadeus Mozart 这 样 的 姓名 吗 ? """ 
@ formatted name = get formatted name( 
'wolfgang', 'mozart', 'amadeus') 
self.assertEqual(formatted name, 'Wolfgang Amadeus Mozart') 


if name == ' main _": 
unittest.main() 


将 该 方法 命名 为 test_first_last_middle_name() 。 方 法 名 必须 


以 test_ 打头 ， 这 样 它 才 会 在 我 们 运行 test_name_function.py 时 上 自动 
运行 。 这 个 方法 名 清楚 地 指出 了 它 测试 的 

是 get_formatted_name() 的 哪个 行为 。 这 样 ， 如 果 该 测试 未 通 
过 ， 我 们 就 能 马上 知道 受 影响 的 是 哪 种 类 型 的 姓名 。 可 以 

在 TestCase 类 中 使 用 很 长 的 方法 名 ， 而 且 这 些 方法 名 必须 是 描述 
性 的 ， 这 样 你 才能 看 懂 测 试 未 通过 时 的 输出 。 这 些 方 法 由 Python 自 
动 调用 ， 你 根本 不 用 编写 调用 它们 的 代码 。 


为 测试 函数 get_formatted_name() ， 我 们 使 用 名 、 姓 和 中 间 名 
调用 它 〈 见 @) ， 再 使 用 assertEqual() 检查 返回 的 姓名 是 和 否 后 
预期 的 姓名 《名 、 中 间 名 和 姓 ) 一 致 。 再 次 运行 
test_name_function.py 时 ， 两 个 测试 都 通过 了 : 


Ran 2 tests in 6.60606s 


OK 


太 好 了 ! 现在 我 们 知道 ， 这 个 函数 又 能 正确 地 处 理 像 Janis Joplin 这 
样 的 姓名 了 ， 而 且 深 信 它 也 能 够 正确 地 处 理 像 Wolfgang Amadeus 
Mozart 这 样 的 姓名 。 


动手 试 一 斌 


练习 11-1: 城市 和 国家 ”编写 一 个 函数 ， 它 接受 两 个 形 参 : 
一 个 城市 名 和 一 个 国家 名 。 这 个 函数 返回 一 个 格式 为 City ， 
Country 的 字符 串 ， 如 Santiago，Chile 。 将 这 个 函数 存储 
在 一 个 名 为 city_functions.py 的 模块 中 。 


创建 一 个 名 为 test_cities.py 的 程序 ， 对 刚才 编写 的 函数 进行 测 
试 〈 别 忘 了 ， 需 要 导入 模块 unittest 和 要 测试 的 函数 ) 。 编 
写 一 个 名 为 test_city_country() 的 方法 ， 核 实 使 用 类 似 
于 "santiago' 和 'chile' 这 样 的 值 来 调用 前 述 函 数 时 ， 得 到 
的 字符 串 是 正确 的 。 运 行 test_cities.py， 确 认 测 试 
test_city_country() 通过 了 。 


练习 11-2: 人 口 数量 ”修改 前 面 的 函数 ， 加 上 第 三 个 必 不 可 
少 的 形 参 population ， 并 返回 一 个 格式 为 City ，Country 
- popuLation xxx 的 字符 串 ， 如 Santiago，Chile - 
population 5666666 。 运 行 test_cities.py， 确 认 测 试 
test_city_country() 未 通过 。 


修改 上 述 函 数 ， 将 形 参 population 设置 为 可 选 的 。 再 次 运行 
test_cities.py， 确 认 测 试 test_city_country() 又 通过 了 。 


再 编写 一 个 名 为 test_city_country_population() 的 测 
试 ， 核 实 可 以 使 用 类 似 于 'santiago' 、'chile' 

和 "population=5666666' 这 样 的 值 来 调用 这 个 函数 。 再 次 
运行 test_cities.py， 确 认 测 试 
test_city_country_population() 通过 了 。 


11.2 ”测试 类 


在 本 章 前 半 部 分 ， 你 编写 了 针对 单个 函数 的 汕 试 ， 下 面 来 编写 针对 
类 的 测试 。 很 多 程序 中 都 会 用 到 类 ， 因 此 证 明 你 的 类 能 够 正确 工作 
大 有 人 神 益 。 如 果 针 对 类 的 测试 通过 了 ， 你 束 能 确信 对 类 所 做 的 改进 
没有 意外 地 破坏 其 原 有 的 行为 。 


11.2.1 各 种 断言 方法 


Python 在 unittest.TestCase 类 中 提供 了 很 多 断言 方法 。 前 面 说 
过 ， 上 断言 方法 检查 你 认为 应 该 满足 的 条 件 是 否 确实 满足 。 如 果 该 条 
件 确实 满足 ， 你 对 程序 行为 的 假设 就 得 到 了 确认 ， 可 以 确信 其 中 没 
如 采 你 认为 应 该 满足 的 条 件 实际 上 并 不 满足 ，Python 将 引 
异 芝 。 


表 11-1 描 述 了 6 个 常用 的 断言 方法 。 使 用 这 些 方法 可 核实 返回 的 值 
等 于 或 不 等 于 预期 的 值 ， 返 回 的 值 为 True 或 False ， 以 及 返回 的 
值 在 列表 中 或 不 在 列表 中 。 只 能 在 继承 unittest.TestCase 的 类 


中 使 用 这 些 方法 ， 随 后 来 看 看 如 何在 测试 类 时 使 用 其 中 之 一 。 
表 11-1 ”unittest 模 块 中 的 断言 方法 


assertEqual(a, b) 核实 a == b 
assertNotEqual(a, b) 核实 a != b 


assertTrue(x) 核实 x 为 True 
assertFalse(x) 核实 x 为 False 


assertIin(item , List ) 核实 item 在 List 中 


11.2.2 一 个 要 测试 的 类 


类 的 测试 与 函数 的 测试 相似 ， 你 所 做 的 大 部 分 工作 古 测 试 类 中 方法 
的 行为 。 不 过 还 是 存在 一 些 不 同 之 处 ， 下 面 编写 一 个 要 测试 的 类 。 
来 看 一 个 帮助 管理 匿名 调查 的 类 : 


Survey.py 


class AnonymousSurvey: 


""" 收 集 匿名 调查 问卷 的 答案 。""" 


def _init (self, question): 
"" "存储 一 个 问题 ， 并 为 存储 答案 做 准备 。""" 
self.question = question 
self.responses = [|] 


show_question(self): 
mm 显示 调查 问卷 。 LEE 
print(self.question) 


store response(self, new response): 
mm "存储 单 份 调查 答卷 。 ma 


self.responses.append(new_response) 


show_ results(self): 

'" "显示 收集 到 的 所 有 答卷 。""" 

print("Survey results:") 

for response jin self.responses: 
print(f"- {response}") 


这 个 类 首先 存储 了 一 个 调查 问题 ( 见 @) ， 并 创建 了 一 个 空 列表 ， 
用 于 存储 答案 。 这 个 类 包含 打印 调查 问题 的 方法 〈( 见 @@); ， 在 答案 
列表 中 添加 新 答案 的 方法 ( 见 @) ， 以 及 将 存储 在 列表 中 的 答案 都 
打印 出 来 的 方法 〈 见 四 ) 。 要 创建 该 类 的 实例 ， 只 需 提 供 一 个 问题 
即 可 。 有 了 表示 调查 的 实例 后 ， 束 可 使 用 show_question() 来 显 
示 其 中 的 问题 ， 使 用 store_response() 来 存储 答案 并 使 


用 show_results() 来 显示 调查 结果 。 


为 证 明 AnonymousSurvey 类 能 够 正确 工作 ， 编 写 一 个 使 用 它 的 程 
序 : 


language_survey.py 


from survey import AnonymousSurvey 


# 定义 一 个 问题 ， 并 创建 一 个 调查 。 
question = "What language did you first learn to speak?" 
my_survey = AnonymousSurvey(question) 


# 显示 问题 并 存储 答案 。 
my_survey.show question() 
print("Enter 'q' at any time to quit.\n") 
while True: 

response = input("Language: ") 

if response == 'q': 

break 
my_survey.store_ response(response) 


# 显示 调查 结果 。 
print("\nThank you to everyone who participated in the survey!") 
my_survey.show results() 


这 个 程序 定义 了 一 个 问题 ("What language did you first 
learn to speak? " ) ， 并 使 用 该 问题 创建 了 一 

个 AnonymousSurvey 对 象 。 接 下 来 ， 这 个 程序 调 

用 show_question() 来 显示 问题 ， 并 提示 用 户 输 入 答案 。 在 收 到 
每 个 答案 的 同时 将 其 存储 起 来 。 用 户 输入 所 有 答案 (输入 q 要求 退 
出 ) 后 ， 调 用 show_results() 来 打印 调查 结果 : 


What language did you first learn to speak? 
Enter 'q' at any time to quit. 


Language: English 
Language: Spanish 
Language: English 
Language: Mandarin 
Language: 9q 


Thank you to everyone who participated in the survey! 
Survey results: 

- English 

- Spanish 

- English 

- Mandarin 


AnonymousSurvey 类 可 用 于 进行 简单 的 匿名 调查 。 假 设 我 们 将 它 
放 在 了 模块 survey 中 ， 并 想 进 行 改进 : 让 每 位 用 户 都 可 输入 多 个 
答案 ; 编写 一 个 方法 ， 只 列 出 不 同 的 答案 并 指出 每 个 答案 出 现 了 多 


少 次 ;再 编写 一 个 类 ， 用 于 管理 非 匿 名 调查 。 


进行 上 述 修改 存在 风险 ， 可 能 影响 AnonymousSurvey 类 的 当前 行 
为 。 例 如 ， 人 允许 每 位 用 户 输入 多 个 答案 时 ， 可 能 会 不 小 心 修改 处 理 
单个 答案 的 方式 。 要 确认 在 开发 这 个 模块 时 没有 破坏 既 有 行为 ， 可 
以 编写 针对 这 个 类 的 测试 。 


11.2.3 测试 AnonymousSurvey 类 


下 面 来 编写 一 个 测试 ， 对 AnonymousSurvey 类 的 行为 的 一 个 方面 
进行 验证 : 如果 用 户 面 对 调查 问题 只 提供 一 个 答案 ， 这 个 答案 也 能 
被 妥善 地 存储 。 为 此 ， 我 们 将 在 这 个 答案 被 存储 后 ， 使 用 方法 
assertIn() 来 核实 它 确实 在 答案 列表 中 : 


test_survey.py 


import unittest 
from survey import AnonymousSurvey 


@ class TestAnonymousSurvey(unittest.TestCase): 
"" "针对 AnonymousSurvey 类 的 测试 。""" 


@ def test store single response(self): 

""" 测 试 单个 答案 会 被 妥善 地 存储 。""" 

question = "What language did you first learn to speak?" 
© my_survey = AnonymousSurvey(question) 

my_survey.store response('English') 
@ self.assertIn( "English'，my survey.responses ) 


if name == ' Mmain  ": 


unittest.main() 


首先 导入 模块 unittest 和 要 测试 的 类 AnonymousSurvey 。 将 测试 
用 例 命名 为 TestAnonymousSurvey ， 它 也 继承 了 
unittest.TestCase ( 见 @) 。 第 一 个 测试 方法 验证 : 调查 问题 
的 单个 答案 被 存储 后 ， 会 包含 在 调查 结果 列表 中 。 对 于 这 个 方法 ， 
一 个 不 错 的 描述 性 名 称 是 test_store_single_response() ( 见 
外) 。 如 果 这 个 测试 未 通过 ， 我 们 就 能 通过 输出 中 的 方法 名 得 知 ， 
在 存储 单个 调查 答案 方面 存在 问题 。 


要 测试 类 的 行为 ， 需 要 创建 其 实例 。 在 全 处 ， 使 用 问题 "What 
language did you first learn to speak?" 创建 一 个 名 

为 my_survey 的 实例 ， 然 后 使 用 方法 store_response() 存储 单 
个 答案 English 。 接 下 来 ， 检 查 English 是 否 包含 在 列 

表 my_survey.responses 中 ， 以 核实 这 个 答案 是 否 被 妥善 地 存储 
了 (nN@). 


当 我 们 运行 test_survey.py 时 ， 测 试 通过 了 : 


Ran 1 test in 68.6081s 


OK 


这 很 好 ， 但 只 能 收集 一 个 答案 的 调查 用 途 不 大 。 下 面 来 核实 当 用 户 
提供 三 个 答案 时 ， 它 们 也 将 被 妥善 地 存储 。 为 此 ， 
在 TestAnonymousSurvey 中 再 添加 一 个 方法 : 


import unittest 
from survey import AnonymousSurvey 


class TestAnonymousSurvey(unittest.TestCase): 
""" 针 对 AnonymousSurvey 类 的 测试 。""" 


def test store single response(self): 
--Snip-- 


def test store three responses(self): 
""" 测 试 三 个 答案 会 被 妥善 地 存储 。""" 


question = "What language did you first learn to speak?" 
my_survey = AnonymousSurvey(question) 
@ responses = ['English', 'Spanish', "Mandarin '] 


for response in responses: 
my_survey.store response(response) 


@ for response in responses: 
self.assertIn(response, my_survey.responses) 


if name == ' main _": 
unittest.main() 


我 们 将 该 方法 命名 为 test_store three_responses() ， 并 像 对 
test_store_single_response() 所 做 的 一 样 ， 在 其 中 创建 一 个 
调查 对 象 。 定 义 一 个 包含 三 个 不 同 答案 的 列表 ( 见 @) ， 再 对 其 中 
每 个 答案 调用 store_response() 。 存 储 这 些 答案 后 ， 使 用 一 个 循 
环 来 确认 每 个 答案 都 包含 在 my_survey.responses 中 ( 见 @) 。 


再 次 运行 test_survey.py 时 ， 两 个 测试 (针对 单个 答案 的 测试 和 人 针对 
三 个 答案 的 测试 ) 都 通过 了 : 


Ran 2 tests in 6.066s 


OK 


前 述 做 法 的 效果 很 好 ， 但 这 些 测试 有 些 重复 的 地 方 。 下 面 使 
用 unittest 的 另 一 项 功能 来 提高 其 效率 。 


11.2.4 ”方法 setUp() 
在 前 面 的 test_survey.py 中 ， 我 们 在 每 个 测试 方法 中 都 创建 了 一 


个 AnonymousSurvey 实例 ， 并 在 每 个 方法 中 都 创建 了 答 
案 。unittest.TestCase 类 包含 的 方法 setUp() 让 我 们 只 需 创 建 


这 些 对 象 一 次 ， 就 能 在 每 个 测试 方法 中 使 用 。 如 果 在 TestCase 类 
中 包含 了 方法 setUp() ，Python 将 先 运行 它 ， 再 运行 各 个 以 test_ 
打头 的 方法 。 这 样 ， 在 你 编写 的 每 个 测试 方法 中 ， 都 可 使 用 在 方法 
setUp() 中 创建 的 对 象 。 


下 面 使 用 setUp() 来 创建 一 个 调查 对 象 和 一 组 答案 ， 供 方法 
test store single response() 和 
test_store three_responses() 使 用 : 


import unittest 
from survey import AnonymousSurvey 


class TestAnonymousSurvey(unittest.TestCase): 
""" 针 对 AnonymousSurvey 类 的 测试 。""" 


def setUp(self): 


创建 一 个 调查 对 象 和 一 组 答案 ， 供 使 用 的 测试 方法 使 用 。 


question = "What language did you first learn to speak?" 
self.my_survey = AnonymousSurvey (question) 
self.responses = ['English', 'Spanish', 'Mandarin'] 


test store single response(self): 

"" "测试 单个 答案 会 被 妥善 地 存储 。""" 

self.my_survey.store response(self.responses[08]) 
self.assertIn(self.responses[8], self.my_survey.responses) 


test store three responses(self): 

""" 测 试 三 个 答案 会 被 妥善 地 存储 。""" 

for response in self.responses: 
self.my_survey.store_ response(response) 

for response in self.responses: 
self.assertIn(response, self.my_survey.responses) 


if name == "main _": 
unittest.main() 


方法 setUp() 做 了 两 件 事情 : 创建 一 个 调查 对 象 ( 见 @) ， 以 及 创 
府 一 个 答案 列 表 〈 见 介 ) 。 存 储 这 两 样 东 西 的 变量 名 包含 前 缀 self 
〈 即 存储 在 属性 中 ) ， 因 此 可 在 这 个 类 的 任何 地 方 使 用 。 这 让 两 个 
测试 方法 都 更 简单 ， 因 为 它们 都 不 用 创建 调查 对 象 和 答案 了 。 方 法 


test_store single_response() 核实 self.responses 中 的 第 
一 个 答案 self.responses[8] 被 妥善 地 存储 ， 而 方法 
test_store three_response() 核实 self.responses 中 的 全 部 
三 个 答案 都 被 妥善 地 存储 。 


再 次 运行 test_survey.py 时 ， 这 两 个 测试 也 都 通过 了 。 如 果 要 扩 

展 AnonymousSurvey ， 使 其 允许 每 位 用 户 输 入 多 个 答案 ， 这 些 测 
试 将 很 有 有 用。 修改 代码 以 接受 多 个 答案 后 ， 可 运行 这 些 测试 ， 确 认 
存储 单个 答案 或 一 系列 答案 的 行为 未 受 影响 。 


测试 自己 编写 的 类 时 ， 方 法 setup() 让 测试 方法 编写 起 来 更 容易 : 
可 在 setUp() 方法 中 创建 一 系列 实例 并 设置 其 属性 ， 再 在 测试 方法 
中 直接 使 用 这 些 实例 。 相 比 于 在 每 个 测试 方法 中 都 创建 实例 并 设置 
其 属性 ， 这 要 容易 得 多 。 


注意 ”运行 测试 用 例 时 ， 每 完成 一 个 单元 测试 ，Python 痢 打印 
一 个 字符 : 测试 通过 时 打印 一 个 名 点， 测试 引发 错误 时 打印 一 
个 E ， 而 测试 导致 断言 失 败 时 则 打印 一 个 F 。 这 就 是 你 运行 测 
试用 例 时 ， 在 输出 的 第 一 行 中 看 到 的 句点 和 字符 数量 各 不 相同 
的 原因 。 如 宁 测 试用 例 包含 很 多 单元 测试 ， 需 要 运行 很 长 时 
间 ， 就 可 通过 观察 这 些 结果 来 获悉 有 多 少 个 测试 通过 了 。 


动手 试 一 斌 


练习 11-3: 雇员 ”编写 一 个 名 为 Employee 的 类 ， 其 方法 
init () 接受 名 、 姓 和 年 薪 ， 并 将 它们 存储 在 属性 中 。 编 
写 一 个 名 为 give_raise() 的 方法 ， 它 默认 将 年 薪 增 加 5000 美 
元 ， 但 也 能 够 接受 其 他 的 年 薪 增 加 量 。 


为 Employee 编写 一 个 测试 用 例 ， 其 中 包含 两 个 测试 方 

法 : test_give_default_raise() 和 
test_give_custom_raise()。 使 用 方法 setUp() ， 以 免 在 
每 个 测试 方法 中 都 新 建 雇员 实例 。 运 行 这 个 测试 用 例 ， 确 认 两 
个 测试 都 通过 了 。 


11.3 小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 模块 unittest 中 的 工具 来 为 函数 
和 类 编写 测试 ， 如 何 编 写 继承 unittest.TestCase 的 类 ， 以 及 如 
何 编写 测试 方法 ， 以 核实 函数 和 类 的 行为 符合 预期 ， 如 何 使 用 方法 
setUp() 来 根据 类 高 效 地 创建 实例 并 设置 其 属性 ， 以 便 在 类 的 所 有 
测试 方法 中 使 用 。 


测试 是 很 多 初学 者 不 熟悉 的 主题 。 作 为 初学 者 ， 并 非 必须 为 你 尝试 
的 所 有 项 目 编写 测试 。 然 而 参与 工作 量 较 大 的 项 目 时 ， 你 应 该 对 自 
己 所 编写 函数 和 类 的 重要 行为 进行 测试 。 这 样 你 就 能 够 更 加 确定 目 
己 所 做 的 工作 不 会 破坏 项 目的 其 他 部 分 ， 从 而 自由 地 改进 既 有 代 

码 。 如 果 不 小 心 破坏 了 原来 的 功能 ， 你 马上 就 会 知道 ， 而 且 能 够 轻 
松 地 修复 问题 。 比 起 等 到 不 满意 的 用 户 报告 bug 后 再 采取 措施 ， 在 
测试 未 通过 时 采取 措施 要 容易 得 多 。 


如 果 你 在 项 目 中 包含 了 初步 测试 ， 将 得 到 其 他 程序 员 的 恒 敬 。 他 们 
不 仅 能 够 更 得 心 应 手 地 使 用 你 编写 的 代码 ， 也 更 愿意 与 你 合作 开发 
项 目 。 如 果 要 跟 其 他 程序 员 开 发 的 项 目 共享 代码 ， 就 必须 证 明 你 编 
写 的 代码 通过 了 妹 有 测试 ， 通 第 还 需要 为 你 添加 的 新 行为 编写 测 
试 9 

请 通过 多 开展 测试 来 熟悉 代码 测试 过 程 。 对 于 目 己 编号 的 函数 和 


类 ， 请 编写 针对 其 重要 行为 的 测试 。 不 过 不 要 在 项 目 早期 试图 编写 
全 覆盖 的 测试 用 例 ， 除 非 有 充分 的 理由 。 


第 二 部 分 “项目 


祝 次 你 ! 你 现在 已 经 对 Python 有 足够 的 认识 ， 可 以 开始 开发 有 意思 
的 交互 式 项 目 了 。 通 过 动手 开发 项 目 ， 你 能 够 学 到 新 技能 ， 并 更 深 
入 理解 第 一 部 分 介绍 的 概念 。 


第 二 部 分 包含 三 个 不 同类 型 的 项 目 ， 你 可 以 选择 完成 其 中 的 任意 或 
全 部 项 目 ， 完 成 的 顺序 无 关 紧 要 。 下 面 简要 描述 每 个 项 目 ， 帮 助 你 
决定 移 去 完成 哪个 。 


外 星人 入 侵 : 使 用 Python 开发 游戏 


在 项 目 “ 外 星人 入 侵 ”( 第 12 章 一 第 14 章 ) 中 ， 你 将 使 用 Pygame 包 来 
开发 一 亚 2D 游 戏 。 它 在 玩家 每 消灭 一 群 向 下 移动 的 外 星人 后 ， 将 
玩家 提高 一 个 等 级 。 等 级 越 高 ， 游 戏 的 节奏 越 快 ， 难 度 越 大 。 完 成 
这 个 项 目 后 ， 你 将 获得 自己 动手 使 用 Pygame 开 发 2D 游 戏 所 需 的 技 


能 。 
数据 可 视 化 


“数据 可 视 化 "项目 始 于 第 15 章 ， 你 将 在 这 一 章 学 习 如 何 使 用 
Matplotlib 和 Plotly 来 生成 数据 ， 以 及 根据 这 些 数据 创建 实用 而 漂亮 
的 图 表 。 第 16 章 介绍 如 何 从 网 上 获取 数据 ， 并 将 其 提供 给 可 视 化 包 
以 创建 天 气 图 和 世界 地 震 活动 散 点 图 。 最 后 ， 第 17 章 介绍 如 何 编写 
自动 下 载 数据 并 对 其 进行 可 视 化 的 程序 。 学 习 可 视 化 让 你 能 够 探索 
数据 挖掘 领域 ， 这 是 当前 在 全 球 都 非常 热门 的 技能 。 


Web 应 用 程序 


在 “Web 应 用 程序 "项 目 (第 18 章 ~ 第 20 章 ) 中 ， 你 将 使 用 Django 包 
来 创建 一 个 简单 的 Web 应 用 程序 ， 让 用 户 能 够 记录 任意 数量 的 学 习 
主题 。 用 户 将 通过 指定 用 户 名 和 密码 来 创建 账户 ， 输 入 主题 ， 并 编 
写 条 目 来 记录 学 习 的 内 容 。 你 还 将 学 习 如 何 部 署 应 用 程序 ， 让 任何 
人 都 能 够 访问 它 。 


完成 这 个 项 目 后 ， 你 将 能 够 目 己 动手 创建 简单 的 web 应 用 程序 ， 并 


能 够 深入 学 习 其 他 有 关 如 何 使 用 Django 开 发 应 用 程序 的 资料 。 


项 目 1 外 星人 入 侵 


~ 我 们 来 开发 一 个 名 为 《外 星人 入 侵 》 的 游戏 吧 ! 
为 此 将 使 用 Pygame， 这 是 一 组 功能 强大 而 有 趣 的 模块 ， 可 用 
于 管理 图 形 、 动 画 乃 至 声音 ， 让 你 能 够 更 轻松 地 开发 复杂 的 游 
戏 。 通 过 使 用 Pygame 来 处 理 在 屏幕 上 绘制 图 像 等 任务 ， 可 将 
重点 放 在 程序 的 高 级 逻辑 上 。 


在 本 章 中 ， 你 将 安装 Pygame， 再 创建 一 稻 能 够 根据 用 户 输入 
左右 移动 和 射击 的 飞 胎 。 在 接 下 来 的 两 章 ， 你 将 创建 一 群 作为 
射 杀 目标 的 外 星人 ， 并 改进 该 游戏 : 限制 可 供 玩家 使 用 的 飞船 
数 ， 并 且 添 加 记分 牌 。 


在 开发 这 款 游戏 的 过 程 中 ， 你 还 将 学 习 如 何 管理 包含 多 个 文件 
的 项 目 。 你 将 重 构 很 多 代码 并 管理 文件 的 内 容 ， 以 确保 项 目 组 
织 有 订 以 及 提高 效率 。 


开发 游戏 是 趣 学 语言 的 理想 方式 。 看 别人 玩 你 编写 的 游戏 能 获 
得 满足 感 ， 而 编写 简单 的 游戏 有 助 于 你 明白 专业 级 游戏 是 怎么 
编写 出 来 的 。 在 阅读 本 章 的 过 程 中 ， 请 动手 输入 并 运行 代码 ， 
以 明白 各 个 代码 块 对 整个 游戏 所 做 的 页 献 ， 并 且 尝 试 不 同 的 值 
和 设置 ， 以 对 如 何 改进 游戏 的 交互 性 有 更 深入 的 认识 。 


注意 ”游戏 《外 星人 入 侵 》 将 包含 很 多 不 同 的 文件 ， 因 此 请 

在 系统 中 新 建 一 个 名 为 alien_invasion 的 文件 夹 ， 并 将 该 项 目的 

000 0 
全 工作 。 


另外 ， 如 宋 你 熟悉 版 本 控制 ， 可 能 想 将 其 用 于 这 个 项 目 ， 如 宁 
你 没有 使 用 过 版 本 控制 ， 请 参阅 附录 D 的 概述 。 


12.1 规划 项 目 


开发 大 型 项 目 时 ， 制 定好 规划 后 再 动手 编写 代码 很 重要 。 规 划 可 确 
保 你 不 侦 离 轨道 ， 从 而 提高 项 目 成 功 的 可 能 性 。 


下 面 来 编写 有 关 游 戏 《 外 星人 入 侵 》 的 描述 ， 其 中 虽然 没有 涵盖 这 
于 游戏 的 所 有 细 市 ， 但 能 让 你 清楚 地 知道 该 如 何 动 手 开发。 


在 游戏 《外 星人 入 侵 》 中 ， 玩 家 控制 一 艘 最 初出 现在 屏幕 的 部 
中 央 的 飞 朋 。 玩 家 可 以 使 用 币 头 键 左右 移动 飞船 ， 还 可 使 用 空 
格 键 射 击 。 游 戏 开 始 时 ， 一 群 外 星人 出 现在 天 空中 ， 并 回 屏 幕 
下 方 移动 。 玩 家 的 任务 是 射 杀 这 些 外 星人 。 玩 家 将 所 有 外 星人 
都 消灭 干净 后 ， 将 出 现 一 群 新 的 外 星人 ， 其 移动 速度 更 快 。 只 
要 有 外 星人 撞 到 玩家 的 飞船 或 到 达 屏 妖 底 部 ， 玩 家 就 损失 一 般 
飞船 。 玩 家 损失 三 艘 飞船 后 ， 游 戏 结束 。 


开发 的 第 一 个 阶段 将 创建 一 艘 飞船， 它 可 左右 移动 ， 并 且 能 在 用 户 
按 空格 键 时 开火 。 设 置 好 这 种 行为 后 ， 殊 可 以 创建 外 星人 并 提高 洲 
戏 的 可 玩 性 了 。 


12.2 ”安装 Pygame 


开始 编码 前 ， 先 来 安装 Pygame。 可 使 用 pip 模块 来 帮助 下 载 并 安装 
Python 包 。 要 安装 Pygame， 在 终端 提示 符 下 执行 如 下 命令 : 


$ python -m pip install --user pygame 


这 个 命令 让 Python 运行 pip 模块 ， 将 pygame 包 添 加 到 当前 用 户 的 
Python 安装 中 。 如 果 你 运行 程序 或 启动 终端 会 话 时 使 用 的 命令 不 
是 python ， 而 是 python3 ， 请 执行 如 下 命令 来 安装 Pygame: 


$ python3 -m pip install --user pygame 


注意 ”如果 该 命令 在 macOS 系 统 中 不 管用 ， 请 尝试 在 不 指定 
标志 --user 的 情况 下 再 次 执行 。 


12.3 ”开始 游戏 项 目 


开始 开发 游戏 《外 星人 入 侵 》 吧 。 首 先 要 创建 一 个 空 的 Pygame 窗 
口 ， 供 之 后 用 来 绘制 游戏 元 素 ， 如 飞船 和 外 星人 。 我 们 还 将 让 这 个 
游戏 啊 应 用 户 输 入 ， 设 置 背 景色 ， 以 及 加 载 飞 船 图 像 。 


12.3.1 创建 Pygame 窗 口 及 响应 用 户 输 入 

下 面 创建 一 个 表示 游戏 的 类 ， 以 创建 空 的 Pygame 窗 口 。 为 此 ， 在 
文本 编辑 器 中 新 建 一 个 文件 ， 将 其 保存 为 alien_invasion.py， 再 在 其 
中 输入 如 下 代码 : 


alien_invasion.py 


import sys 


import pygame 


class AlienInvasion: 
“"" 管 理 游戏 资源 和 行为 的 类 """ 


def _ init (self): 
"" "初始 化 游戏 并 创建 游戏 资源 。""" 
@ pygame.init() 


@ self.screen = pygame.display.set mode((1260, 8060)) 
pygame.display.set caption("Alien Invasion") 


def run_ game(self): 


"" "开始 游 戏 的 主 循环 """ 
[3 while True: 
# 监视 键盘 和 鼠标 事件 。 
@ for event in pygame.event .get() : 
© if event.type == pygame.QUIT : 
sys.exit() 


# 让 最 近 绘制 的 屏幕 可 见 。 
© pygame.display.flip() 


if name == ' main _": 
# 创建 游戏 实例 并 运行 游戏 。 
ai = AlienInvasion() 


ai.run game() 


首先 ， 导 入 模块 sys 和 pygame 。 模 块 pygame 包含 开发 游戏 所 需 的 
功能 。 玩 家 退出 时 ， 我 们 将 使 用 模块 sys 中 的 工具 来 退出 游戏 。 


为 开发 游戏 《外 星人 入 侵 》， 我 们 创建 了 一 个 表示 它 的 类 ， 名 
为 AlienInvasion 。 在 这 个 类 的 方法 _ init _() 中 ， 调 用 函 

数 pygame .init() 来 初始 化 背景 设置 ， 让 Pygame 能 够 正确 地 工作 
( 见 @)，。 在 @ 处 ， 调 用 pygame.display .set _mode() 来 创建 一 
个 显示 窗口 ， 游 戏 的 所 有 图 形 元 素 都 将 在 其 中 绘制 。 实 参 (1280， 
866) 是 一 个 元 组 ， 指 定 了 游戏 窗口 的 尺寸 一 一 宽 1200 像 素 、 高 800 
像素 《你 可 以 根据 自己 的 显示 器 尺寸 调整 这 些 值 ) 。 将 这 个 显示 窗 
口 赋 给 属性 self.screen ， 让 这 个 类 中 的 所 有 方法 都 能 够 使 用 

1 


赋 给 属性 self.screen 的 对 象 是 一 个 surface 。 在 Pygame 中 ， 

surface 是 屏幕 的 一 部 分 ， 用 于 显示 游戏 元 素 。 在 这 个 游戏 中 ， 每 个 

元 素 〈 如 外 星人 或 飞船 ) 都 是 一 个 surface。display.set_mode() 

返回 的 surface 表 示 整 个 游戏 窗口 。 激 活 游 戏 的 动画 循环 后 ， 每 经 过 

nn 
昌 洲 。 


这 个 游戏 由 方法 run_game() 控制 。 该 方法 包含 一 个 不 断 运行 的 
while 循环 〈( 见 @) ， 而 这 个 循环 包含 一 个 事件 循环 以 及 管理 屏幕 
更 新 的 代码 。 事 件 是 用 户 玩 游戏 时 执行 的 操作 ， 如 按键 或 移动 鼠 
标 。 为 程序 响应 事件 ， 可 编写 一 个 事件 循环 ， 以 侦 听 事件 并 根据 
四 处 的 for 循环 就 是 一 个 事件 循 


为 访问 Pygame 检 测 到 的 事件 ， 我 们 使 用 了 函 

数 pygame.event.get() 。 这 个 函数 返回 一 个 列表 ， 其 中 包含 它 在 

上 一 次 被 调用 后 发 生 的 所 有 事件 。 所 有 键盘 和 鼠标 事件 都 将 导致 这 

个 for 循环 运行 。 在 这 个 循环 中 ， 我 们 将 编写 一 系列 if 语句 来 检 

测 并 响应 特定 的 事件 。 例 如 ， 当 玩家 单 击 游戏 窗口 的 关闭 按钮 时 ， 

Be .QUIT 事件 ， 进 而 调用 sys .exit() 来 退出 游戏 
( 见 @) 。 


@ 处 调用 了 pygame.display.flip() ， 命 pe dl 
屏幕 可 见 。 在 这 里 ， 它 在 每 次 执行 while 循环 时 都 绘制 一 

若 ， 并 禾 穴 四 屏幕 ， 使 乱 只 有 新 屏 尖 可 中 。 我 们 移 起 游 戏 元 素 
时 ，pygame.display.flip() 将 个 断 更 新 屏 医 ， 以 显示 元 素 的 新 
位 置 ， 并 且 在 原来 的 位 置 隐藏 元 素 ， 从 而 营造 平滑 移动 的 效果 。 


在 这 个 文件 末尾 ， 创 建 一 个 游戏 实例 并 调用 run_game() 。 这 些 代 
人 码 放 在 一 个 if 代码 块 中 ， 仅 当 直 接 运 径 行 该 文 作 时 ， 它们 才 会 执 
行 。 如 果 此 时 运行 alien_invasion.py， 将 看 到 一 个 空 的 Pygame 窗 
口 。 


12.3.2 设置 背景 


Pygame 默 认 创建 一 个 黑色 屏幕 ， 这 太 乏 味 了。 下面 来 将 背景 设置 
为 男 一 种 颜色 ， 这 是 在 方法 _init__() 末尾 进行 的 : 


alien_invasion.py 


def _ init (self): 
--Snip-- 
pygame.display.set caption("Alien Invasion") 


# 设置 背景 
self. De col = (236，236，230) 


run_game(self): 
--Snip-- 
for event in pygame.event .get() : 
if event.type == pygame.QUIT : 
sys.exit() 


# 每 次 循环 时 都 重 绘 屏幕 。 
self.screen.fill(self.bg color) 


# 让 最 近 绘制 的 屏幕 可 见 。 
pygame.display.flip() 


在 Pygame 中 ， 颜 色 是 以 RGB 值 指定 的 。 这 种 闫 色 由 红色 、 绿 色 和 
蓝 色 值 组 成 ， 其 中 每 个 值 的 可 能 取 值 范围 都 是 0~~255。 闫 色 值 (255， 


0, 0) 表 示 红 色 ，(0, 255, 0) 表 示 绿 色 ， 而 (0, 0, 255) 表 示 蓝 色 。 通 过 组 
合 不 同 的 RGB 值 ， 可 创建 1600 万 种 颜色 。 在 颜色 值 (230, 230, 230) 
中 ， 红 色 、 绿 色 和 蓝 色 的 量 相同 ， 它 生成 一 种 浅 灰 色 。 我 们 将 这 种 
颜色 赋 给 了 self.bg_color ( 见 @)， 


在 全 处 ， 调 用 方法 fi11() 用 这 种 背景 色 填 充 屏幕 。 方 法 fil1() 用 
于 处 理 surface， 只 接受 一 个 实 参 : 一 种 颜色 。 


12.3.3 ”创建 设置 类 


每 次 给 游戏 添加 新 功能 时 ， 通 常 也 将 引入 一 些 新 设置 。 下 面 来 编写 
2 的 模块 ， 在 其 中 包含 一 个 名 为 Settings 的 
， 用 于 将 所 有 设置 都 存储 在 一 个 地 方 ， 以 免 在 代码 中 到 处 添加 设 
。 这 样 ， 每 当 需 要 访问 设置 时 ， 只 需 使 用 一 个 设置 对 象 。 另 外 ， 
六 这 使 得 修改 游戏 的 外 观 和 行为 更 容易 : 要 修改 游 
戏 ， 只 需 修 改 〈 接 下 来 将 创建 的 ) settings.py 中 的 一 些 值 ， 而 无 须 
查找 散布 在 项 目 中 的 各 种 设置 。 


在 文件 夹 alien_invasion 中 ， 新 建 一 个 名 为 settings.py 的 文件 ， 并 在 其 
中 添加 如 下 Settings 类 : 


settings.py 


class Settings: 


" "存储 游 戏 《 外 星人 入 侵 》 中 所 有 设置 的 类 """ 


def init (self): 
" "初始 化 游戏 的 设置 。""" 
# 屏幕 设置 
self.screen width = 1266 
self.screen height = 866 
self.bg color = (236，236，236) 


为 在 项 目 中 创建 Settings 实例 并 用 它 来 访问 设置 ， 需 要 将 
alien_invasion.py 修 改 成 下 面 这 样 : 


alien_invasion.py 


--Snip-- 
import pygame 


from settings import Settings 


class AlienInvasion: 
“"" 管 理 游戏 资源 和 行为 的 类 """ 


def _ init (self): 
""" 初 始 化 游戏 并 创建 游戏 资源 。""" 
pygame.init() 
self.settings = Settings() 


self.screen = pygame.display.set model( 
(self.settings.screen width, self.settings.screen height 
pygame.display.set caption("Alien Invasion") 


def run_game(self) : 
--Snip-- 
# 每 次 循环 时 都 重 绘 屏幕 。 
self.screen.fill(self.settings.bg color) 


# 让 最 近 绘 制 的 屏幕 可 见 。 
pygame.display.flip() 


--Snip-- 


在 主 程序 文件 中 ， 导 入 Settings 类 ， 调 用 pygame.init() ， 再 创 
建 一 个 Settings 实例 并 将 其 赋 给 self.settings ( 见 @) 。 创建 
屏幕 时 ( 见 @) ， 使 用 了 self.settings 的 属性 screen_width 
和 screen_height 。 接 下 来 填充 屏幕 时 ， 也 使 用 了 
self.settings 来 访问 背景 色 ( 见 @) 。 


如 果 此 时 运行 alien_invasion.py， 结 果 不 会 有 任何 不 同 ， 因 为 我 们 只 
是 将 设置 移 到 了 不 同 的 地 方 。 现 在 可 以 在 屏 闯 上 添加 新 元 素 了 。 


12.4 添加 飞船 图 像 


下 面 将 飞船 加 入 游戏 中 。 为 了 在 屏幕 上 绘制 玩家 的 飞船 ， 我 们 将 加 
载 一 幅 图 像 ， 再 使 用 Pygame 方 法 blit() 绘制 它 。 


为 游戏 选择 素材 时 ， 务 必要 注意 许可 。 最 安全 、 最 不 费 钱 的 方式 是 
使 用 Pixabay 等 网 站 提供 的 免费 图 形 ， 无 须 授 权 许可 即 可 使 用 并 修 
改 。 


在 游戏 中 几乎 可 以 使 用 任何 类 型 的 图 像 文件 ， 但 使 用 位 图 (.bmp) 
文件 最 为 简单 ， 因 为 pygame 默 认 加 载 位 图 。 虽 然 可 配置 Pygame 以 
使 用 其 他 文件 类 型 ， 但 有 些 文件 类 型 要 求 你 在 计算 机 上 安装 相应 的 
图 像 库 。 大 多 数 图 像 为 .jpg、.png 或 .gif 格式， 但 可 使 用 Photoshop、 
GIMP 和 Paint 等 工具 将 其 转换 为 位 图 。 


选择 图 像 时 ， 要 特别 注意 背景 色 。 请 尽 可 能 选择 背景 为 透明 或 纯色 
的 图 像 ， 便 于 使 用 图 像 编辑 右 将 其 背景 谷 换 为 任意 闫 色 。 图 像 的 背 
景色 与 游戏 的 背景 色 匹 配 时 ， 游 戏 看 起 来 最 漂亮 。 你 也 可 以 将 游戏 
的 背景 色 设 置 成 图 像 的 背景 色 。 


就 游戏 《外 星人 入 侵 》 而 言 ， 可 使 用 文件 ship.bmp《 如 图 12-1 所 
示 ) ， 该 文件 可 在 本 书 主页 (ituring.cn/book/2784〉 的“ 随 书 下 
载 * 中 找到 。 这 个 文件 的 背景 色 与 项 目 使 用 的 设置 相同 。 请 在 项 目 
文件 夹 (alien_invasion〉 中 新 建 一 个 名 为 images 的 文件 夹 ， 并 将 文 
件 ship.bmp 保 存在 其 中 。 


图 12-1 游戏 《外 星人 入 侵 》 中 的 飞船 

12.4.1 创建 Ship 类 

选择 用 于 表示 飞 胎 的 图 像 后 ， 需 要 将 其 显示 到 屏幕 上 。 我 们 创建 一 
个 名 为 ship 的 模块 ， 其 中 包含 ship 类 ， 负 责 管 理 飞 船 的 大 部 分 行 


相 


ship.py 


import pygame 


class Ship: 
""" 管 理 飞船 的 类 """ 


def init (self, ai game): 
"" "初始 化 飞船 并 设置 其 初始 位 置 。""" 
self.screen = ai game.screen 
self.screen rect = ai game.screen.get rect() 


# 加 载 飞船 图 像 并 获取 其 外 接 矩 形 。 
self.image = pygame.image.1load('images/ship.bmp') 
self.rect = self.image.get _ rect() 


# 对 于 每 艘 新 飞船 ， 部 将 其 放 在 屏幕 底部 的 中 央 。 


self.rect.midbottom = self.screen rect.midbottom 


blitme(self): 
""" 在 指定 位 置 绘制 飞船 。""" 


self.screen.blit(self.image, self.rect) 


Pygame 之 所 以 高 效 ， 是 因为 它 让 你 能 够 像 处 理 矩 形 〈rect 对 象 ) 
一 样 处 理 毛 有 的 游戏 元 素 ， 即 便 其 形状 并 非 矩 形 。 像 处 理 窍 形 一 样 
处 理 游 戏 元 素 之 所 以 高 效 ， 是 因为 窍 形 是 简单 的 几何 形状 。 例 如 ， 
通过 将 游戏 元 素 视 为 矩形 ，Pygame 能 够 更 快 地 判断 出 它们 是 否 发 
生 了 碰撞 。 这 种 做 法 的 效果 通 第 很 好 ， 游 戏 玩家 几乎 注意 不 到 我 们 
处 理 的 并 不 是 游戏 元 素 的 实际 形状 。 在 这 个 类 中 ， 我 们 将 把 飞船 和 
屏幕 作为 矩形 进行 处 理 。 


定义 这 个 类 之 前 ， 导 入 了 模块 pygame 。Ship 的 方法 _ init __() 


接受 两 个 参数 : 引用 self 和 指 同 当前 AlienInvasion 实例 的 引 
用 。 这 让 Ship 能 够 访问 AlienInvasion 中 定义 的 所 有 游戏 资源 。 
在 @@ 处 ， 将 屏幕 赋 给 了 Ship 的 一 个 属性 ， 以 便 在 这 个 类 的 所 有 方 
法 中 轻松 访问 。 在 全 处 ， 使 用 方法 get_rect() 访问 屏幕 的 属 

性 rect ， 并 将 其 赋 给 了 self.screen_rect ， 这 让 我 们 能 够 将 飞 
般 放 到 屏幕 的 正确 位 置 。 


调用 pygame .image.1oad() 加 载 图 像 ， 并 将 飞艇 图 像 的 位 置 传递 
给 它 〈( 见 人 全) 。 该 函数 返回 一 个 表示 飞船 的 surface， 而 我 们 将 这 个 
surface 赋 给 了 self.image 。 加 载 图 像 后 ， 使 用 get_rect() 获取 
人 以 便 后 面 能 够 使 用 它 来 指定 飞船 的 位 


处 理 rect 对 象 时 ， 可 使 用 矩形 四 角 和 中 心 的 z 坐标 和 y 坐标 。 可 通 
过 设置 这 些 值 来 指定 矩形 的 位 置 。 要 让 游戏 元 素 居 中 ， 可 设置 相应 
rect 对 象 的 属性 center 、centerx 或 centery ; 要 让 游戏 元 素 与 
屏幕 边缘 对 齐 ， 可 使 用 属性 top 、bottom 、left 或 right 。 除 此 
之 外 ， 还 有 一 些 组 合 属 性 ， 如 midbottom 、midtop 、midleft 和 
midright 。 要 调整 游戏 元 素 的 水 平 或 垂直 位 置 ， 可 使 用 属性 x 和 y 
， 分 别 是 相应 矩形 左上 角 的 z 坐标 和 7Y 坐标 。 这 些 属 性 让 你 无 须 做 

游戏 开发 人 员 原 本 需要 手工 完成 的 计算 ， 因 此 会 经 常用 到 。 


注意 ”在 Pygame 中 ， 原 点 (0, 0) 位 于 屏幕 左上 角 ， 向 右 下 方 移 
动 时 ， 坐 标 值 将 增 大 。 在 1200 x 800 的 屏幕 上 ， 原 点 位 于 左上 
角 ， 而 右 下 角 的 坐标 为 (1200, 800)。 这 些 坐 标 对 应 的 是 游戏 窗 
口 ， 而 不 是 物理 屏幕 。 


我 们 要 将 飞船 放 在 屏幕 确 部 的 中 央 。 为 此 ， 

将 self.rect.midbottom 设置 为 表示 屏幕 的 矩形 的 属 

性 midbottom 〈 见 四 ) 。Pygame 使 用 这 些 rect 属性 来 放置 飞船 图 
像 ， 使 其 与 屏幕 下 边缘 对 齐 并 水 平 居 中 。 


在 四处， 定义 了 方法 blitme() ， 它 将 图 像 绘制 到 self. rect 指定 
的 位 置 。 


12.4.2 ”在 屏幕 上 绘制 飞 舱 
下 面 更 新 alien_invasion.py， 创 建 一 艘 飞船 并 调用 其 方法 blitme() 


alien_invasion.py 


--Snip-- 
from settings import Settings 
from ship import Ship 


class AlienInvasion: 


"管理 游戏 资源 和 行为 的 类 "' 


def init (self): 
--Snip-- 
pygame.display.set caption("Alien Invasion") 


self.ship = Ship(self) 


def run_ game(self): 


--Snip-- 

# 每 次 循环 时 都 重 绘 屏幕 。 
self.screen.fil1l(self.settings.bg_ color) 
self.ship.blitme() 


# 证 最 近 绘 制 的 屏幕 可 见 。 
pygame.display.flip() 
--Snip-- 


导入 Ship 类 ， 并 在 创建 屏幕 后 创建 一 个 Ship 实例 ( 见 @) 。 吝 
用 Ship() 时 ， 必 须 提供 一 个 参数 : 一 个 AlienInvasion 实例 。 在 
这 里 ， self 指向 的 是 当前 AlienInvasion 实例 。 这 个 参数 让 Ship 

能 够 访问 游戏 资源 ， 如 对 象 screen 。 我 们 将 这 个 ship 实例 赋 给 了 
ie 


填充 背景 后 ， 调 用 ship.blitme() 将 飞船 绘 制 到 屏蔽 上 ， 确 保 它 
出 现在 背景 前 面 ( 见 @) 。 


现在 如 果 运 行 alien_invasion.py， 将 看 到 飞船 位 于 空 游 戏 屏 幕 放 部 的 
中 央 ， 如 图 12-2 所 示 。 


图 12-2 ”游戏 《外 星人 入 侵 》 屏 幕 底部 的 中 央 有 一 笨 飞 船 


12.5 重 构 : 方法 _check_events() 和 
Update_screen'( ) 


在 大 型 项 目 中 ， 经 常 需要 在 添加 新 代码 前 重 构 既 有 代码 。 重 构 则 在 

简化 既 有 代码 的 结构 ， 使 其 更 容易 扩展 。 本 节 将 把 越 来 越 长 的 方法 
un 拆 分 成 两 个 辅助 方法 (helper method) 。 辅 助 方法 在 
类 中 执行 任务 ， 但 并 非 是 通过 实例 调用 的 。 在 Python 中 ， 辅 助 方法 
的 名 称 以 单个 下 划 线 打头 。 


12.5.1 方法 _check_events() 


我 们 将 把 管理 事件 的 代码 移 到 一 个 名 为 _check_events() 的 方法 
中 ， 以 简化 run_game( ) 并 隔离 事件 管 理 循环 。 I 
环 ， 可 将 事件 管理 与 游戏 的 其 他 方面 (如 更 新 屏幕 ) 分 离 


下 面 是 新 增 方法 _check_events() 后 的 AlienInvasion 类 ， 只 
有 run_game( ) 的 代码 受到 影响 : 


alien_invasion.py 


def run_ game(self): 

"开始 游戏 主 循环 。 

while True: 
self. check events() 
# 每 次 循环 时 都 重 绘 屏幕 。 


--Snip-- 


def check events(self): 
" "响应 按键 和 鼠标 事件 。""" 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 


新 增 方法 _check_events() ( 见 @) ， 并 将 检查 玩家 是 否 单 击 了 
关闭 窗口 按钮 的 代码 移 到 该 方法 中 。 


要 调用 当 醒 类 的 方法 ， 可 使 用 句点 表示 法 ， 并 指定 变量 名 self 和 
要 调用 的 方法 的 名 称 ( 见 @) 。 我们 在 run_game() 的 while 循环 
中 调用 这 个 新 增 的 方法 。 


12.5.2 方法 _update_screen() 


为 进一步 简化 run_game() ， 将 更 新 屏幕 的 代码 移 到 一 个 名 
为 _ update_screen() 的 方法 中 : 


alien_invasion.py 


def run_ game(self): 
"开始 游戏 主 循环 。""" 
while True: 
self. check events() 
self. update screen() 


def check events(self): 
--Snip-- 


def -update_ screen(self): 

"" 更 新 屏幕 上 的 图 像 ， 并 切换 到 新 屏幕 。 
self.screen.fill(self.settings.bg_ color) 
self.ship.blitme() 


pygame.display.flip() 


我 们 将 绘制 背景 和 飞船 以 及 切换 屏幕 的 代码 移 到 了 方法 
_update_screen() 中 。 现 在 ，run_game() 中 的 主 循环 简单 多 
了 ， 很 容易 看 出 在 每 次 循环 中 都 检测 了 新 发 生 的 事件 并 更 新 了 屏 
央 。 


如 果 你 开发 过 大 量 的 游戏 ， 可 能 早 就 开始 像 这 样 将 代码 放 到 不 同 的 
方法 中 了 。 不 过 如 果 你 从 未 开发 过 这 样 的 项 目 ， 可 能 不 知道 如 何 组 
织 代码 。 这 里 采用 的 做 法 是 ， 先 编写 可 行 的 代码 ， 等 代码 越 来 越 复 
杂 时 再 进行 香 构 ， 以 向 你 展示 真正 的 开发 过 程 ， 先 编写 尽 可 能 简单 
的 代码 ， 等 项 目 越 来 越 复 杂 后 对 其 进行 重 构 。 


对 代码 进行 重 构 使 其 更 容易 扩展 后 ， 可 以 开始 处 理 游戏 的 动态 方面 


人 

动 本 区 二 公 

练习 12-1: 蓝 色 天 空 ”创建 一 个 背景 为 蓝 色 的 Pygame 窗 口 。 

练习 12-2: 游戏 角色 ” 找 一 幅 你 喜欢 的 游戏 角色 位 图 图 像 或 
将 一 幅 图 像 转 换 为 位 图 。 创 建 一 个 类 ， 将 该 角色 绘制 到 屏幕 中 


央 ， 并 将 该 图 像 的 背景 色 设 置 为 屏幕 背景 色 ， 或 者 将 屏幕 背景 
色 设置 为 该 图 像 的 背景 色 。 


12.6 ”各 驶 飞船 


下 面 来 让 玩家 能 够 左右 移动 飞船 。 我 们 将 编写 代码 ， 在 用 户 按 左 或 
右 箭 头 键 时 做 出 啊 应 。 我 们 将 首先 专注 于 回 右 移动 ， 再 使 用 同样 的 
人 通过 这 样 做 ， 你 将 学 会 如 何 控制 屏幕 图 像 的 
移动 。 


12.6.1 啊 应 按键 


每 当 用 户 按 键 时 ， 都 将 在 Pygame 中 注册 一 个 事件 。 事 件 都 是 通过 
方法 pygame .event .get() 获取 的 ， 因 此 需要 在 方法 
_check_events() 中 指定 要 检查 哪些 类 型 的 事件 。 每 次 按键 都 被 
注册 为 一 个 KEYDOWN 事件 。 


Pygame 检 测 到 KEYDOWN 事件 时 ， 需 要 检查 按 下 的 是 否 是 触发 行动 
的 键 。 例 如 ， 如 果 玩 家 按 下 的 是 右 箭 头 键 ， 束 增 大 飞艇 的 
rect.centerx 值 ， 将 飞船 同 右 移动 : 


alien_invasion.py 


def check events(self): 
"" "响应 按键 和 鼠标 事件 。""" 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 
sys.exit() 


elif event.type == pygame .KEYDOWN: 
if event.key == pygame.K_RIGHT: 
# 癌 右 移动 飞船 。 


self.ship.rect.x += 1 


在 方法 _check_events() 中 ， 为 事件 循环 添加 一 个 elif 代码 块 ， 
以 便 在 Pygame 检 测 到 KEYDOWN 事件 时 做 出 啊 应 〈( 见 @) 。 我 们 检 
查 按 下 键 (event.key ) 是 否 是 右 箭头 键 (pygame.K_RIGHT ) 

( 见 @) 。 如 果 是 ， 就 将 self. ship.rect.centerx 的 值 加 1， 从 
而 将 飞船 向 右 移 动 ( 见 @) 。 


如 果 现 在 运行 alien_invasion.py， 则 每 按 右 箭头 键 一 次 ， 飞 船 都 将 辐 
右 移 动 1 像 素 。 这 是 一 个 开端 ， 但 并 非 控制 飞船 的 高 效 方式 。 下 面 
来 改进 控制 方式 ， 允 许 持续 移动 。 


12.6.2 ”人 允许 持续 移动 


玩家 按 住 右 箭头 键 不 放 时 ， 我 们 希望 飞船 不 断 和 癌 右 移动 ， 直 到 玩家 
松 开 为 止 。 我 们 将 让 游戏 检测 pygame.KEYUP 事件 ， 以 便 知 道 玩家 
何 时 松 开 右 箭头 键 。 然 后 ， 结 合 使 用 KEYDONN 和 KEYUP 事件 以 及 一 
个 名 为 moving_right 的 标志 来 实现 持续 移动 。 


当 标 志 moving_right 为 False 时 ， 飞 胎 不 会 移动 。 玩 家 按 下 右 箭 
头 键 时 ， 我 们 将 该 标志 设置 为 True ， 在 玩家 松 开 时 将 该 标志 重新 
设置 为 False 。 


飞船 的 属性 都 由 Ship 类 控制 ， 因 此 要 给 这 个 类 添加 一 个 名 

为 moving_right 的 属性 和 一 个 名 为 update() 的 方法 。 方 法 
update() 检查 标志 moving_right 的 状态 。 如 果 该 标志 为 True ， 
就 调整 飞船 的 位 置 。 我 们 将 在 while 循环 中 调用 这 个 方法 ， 以 调整 
飞船 的 位 置 。 


下 面 是 对 Ship 类 所 做 的 修改 : 


ship.py 


class Ship: 


""" 管 理 飞船 的 类 """ 


def _ init (self, ai game): 
--Snip-- 
# 对 于 每 艘 新 飞船 ， 都 将 其 放 在 屏幕 底部 的 中 央 。 


self.rect.midbottom = self.screen rect.midbottom 


# 移动 标志 。 
© self.moving right = False 


@ def update(self) : 
""" 根 据 移动 标志 调整 飞船 的 位 置 。""" 
if self.moving right: 
self.rect.x += 1 


def blitme(self) : 
--Snip-- 


在 方法 _init () 中 ， 添 加 属性 self.moving_right ， 并 将 其 

初始 值 设置 为 False ( 见 @) 。 接 下 来 ， 添 加 方法 update() ， 在 
前 述 标志 为 True 时 癌 右 移动 飞船 ( 见 介 ) 。 方 法 update() 将 通过 
Ship 实例 来 调用 ， 因 此 不 是 辅助 方法 。 


接 下 来 ， 需 要 修改 _check_events() ， 使 其 在 玩家 按 下 右 箭 头 键 
时 将 moving_right 设置 为 True ， 并 在 玩家 松 开 时 
将 moving_right 设置 为 False : 


alien_invasion.py 


def check events(self): 
"" "响应 按键 和 鼠标 事件 。"”"" 
for event in pygame.event .get() : 
--Snip-- 
elif event .type == pygame .KEYDOWN: 
if event.key == pygame.K_RIGHT: 
self.ship.moving right = True 
elif event.type == pygame .KEYUP: 
if event.key == pygame.K_RIGHT: 
self.ship.moving right = False 


在 @ 处 ， 修 改 游戏 在 玩家 按 下 右 币 头 键 时 啊 应 的 方式 : 不 直接 调整 
飞船 的 位 置 ， 而 只 是 将 moving_right 设置 为 True 。 在 @ 处 ， 添 
加 一 个 新 的 elif 代码 块 ， 用 于 啊 应 KEYUP 事件 : 玩家 松 开 右 箭头 
键 (K_RIGHT ) 时 ， 将 moving_right 设置 为 False 。 


最 后 ， 需 要 修改 run_game() 中 的 while 循环 ， 以 便 每 次 执行 循环 
时 都 调用 飞船 的 方法 update(): 


alien_invasion.py 


def run_ game(self): 
“"" 开 始 游戏 主 循环 。""" 


while True : 
self. check events() 
self.ship.update() 
self. update screen() 


飞船 的 位 置 将 在 检测 到 键盘 事件 后 (但 在 更 新 屏 莫 前) 更新。 这 
样 ， 玩 家 输入 时 ， 飞 船 的 位 置 将 更 新 ， 从 而 确保 使 用 更 新 后 的 位 置 
将 飞 骨 绘制 到 屏 关 上。 


如 果 现 在 运行 alien_invasion.py 并 按 住 右 箭头 键 ， 飞 艇 将 持续 癌 右 移 
动 ， 直 到 松 开 为 止 。 


12.6.3 左右 移动 


现在 飞船 能 够 持续 同 右 移动 了 ， 添 加 同 左 移动 的 逻辑 也 很 容易 。 我 
们 将 再 次 修改 Ship 类 和 方法 _check_events() 。 下 面 显示 了 对 
Ship 类 的 方法 _init () 和 update() 所 做 的 相关 修改 : 


ship.py 


def init (self, ai game): 
--Snip-- 
# 移动 标志 
self.moving right = False 
self.moving left = False 


update(self): 


“" "根据 移动 标志 调整 飞船 的 位 置 。"*" 

if self.moving right: 
self.rect.x += 1 

if self.moving left: 
self.rect.x -= 1 


在 方法 _ init _() 中 ， 添 加 标志 self.moving_left 。 在 方法 
update() 中 ， 添 加 一 个 if 代码 块 而 不 是 elif 代码 块 ， 这 样 如 果 
玩家 同时 按 下 了 左右 箭头 键 ， 将 先 增加 再 减少 飞 妥 的 rect.x 值 ， 
即 飞 船 的 位 置 保持 不 变 。 如 果 使 用 一 个 elif 代码 块 来 处 理 同 左 移 


动 的 情况 ， 右 箭头 键 将 始终 处 于 优先 地 位 。 从 问 左 移动 切换 到 问 右 
玩家 可 能 同时 按 住 左右 箭头 键 ， 此 时 前 面 的 做 法 让 移动 更 
;准确 。 


还 需 对 _check_events() 做 两 方面 的 调整 : 
alien_invasion.py 


def check events(self): 
"" "响应 按键 和 鼠标 事件 。""" 
for event in pygame.event.get() : 
--Snip-- 
elif event .type == pygame.KEYDOWN : 
if event.key == pygame.K_RIGHT : 
self.ship.moving right = True 
elif event.key == pygame.K_LEFT: 
self.ship.moving left = True 


elif event.type == pygame.KEYUP: 
if event.key == pygame.K_RIGHT : 
self.ship.moving right = False 
elif event .key == pygame.K_LEFT : 
self.ship.moving left = False 


如 果 因 玩家 按 下 K_LEFT 键 而 触发 了 KEYDOWN 事件 ， 就 

将 moving_left 设置 为 True 。 如 果 因 玩家 松 开 K_LEFT 而 触发 了 
KEYUP 事件 ， 就 将 moving_left 设置 为 False 。 这 里 之 所 以 可 以 
使 用 elif 代码 块 ， 是 因为 每 个 事件 都 只 与 一 个 键 相 关联 。 如 果 玩 
家 同时 按 下 左右 币 头 键 ， 将 检测 到 两 个 不 同 的 事件 。 


如 果 此 时 运行 alien_invasion.py， 将 能 够 持续 左右 移动 发 了 及。 如 果 同 
时 按 下 左右 第 头 键 ， 飞 般 将 纹 丝 不 动 。 


下 面 来 进一步 优化 飞船 的 移动 方式 : 调整 飞船 的 速度 ， 以 及 限制 飞 
船 的 移动 距离 ， 以 免 其 消失 在 屏幕 之 外 。 


12.6.4 调整 飞船 的 速度 
当前 ， 每 次 执行 while 循环 时 ， 飞 船 最 多 移动 1 像素 ， 但 可 


在 Settings 类 中 添加 属性 ship_speed ， 用 于 控制 飞船 的 速度 。 
我 们 将 根据 这 个 属性 决定 飞船 在 每 次 循环 时 最 多 移动 多 远 。 下 面 演 
示 了 如 何在 settings.py 中 添加 这 个 新 届 性 : 


settings.py 


class Settings: 


""" 存 储 游戏 《外 星人 人 入侵》 中 所 有 设置 的 类 。""" 


def _init (self): 
--Snip-- 


# 飞船 设置 
self.ship speed = 1.5 


将 ship_speed 的 初始 值 设置 为 1.5 。 现 在 需要 移动 飞船 时 ， 每 次 
循环 将 移动 1.5 像 素 而 不 是 1 像素 。 


通过 将 速度 设置 指定 为 小 数值 ， 可 在 后 面 加 快 游戏 市 奏 时 更 细致 地 
控制 飞船 的 速度 。 然 而 ，rect 的 x 等 属性 只 能 存储 整数 值 ， 因 此 


需要 对 Ship 类 做 些 修改 : 


ship.py 


class Ship: 


""" 管 理 飞船 的 类 """ 


@ def _ init (self, ai game): 
"初始 化 飞船 并 设置 其 初始 位 置 。""" 
self.screen = ai game.screen 
self.settings = ai game.settings 
--Snip-- 


# 对 于 每 艘 新 飞船 ， 部 将 其 放 在 屏幕 底部 的 中 央 。 


--Snip-- 


# 在 飞船 的 属性 x 中 存储 小 数值 。 
@ self.x = float(self.rect.x) 


# 移动 标志 
self.moving right = False 


self.moving left = False 


def Update(self) : 
"" "根据 移动 标志 调整 飞船 的 位 置 。""" 
# 更 新 飞船 而 不 是 rect 对 象 的 x 值 。 
if self.moving right: 
@ self.x += self.settings.ship_ speed 
if self.moving left: 
self.x -= self.settings.ship_ speed 


# 根据 self.x 更 新 rect 对 象 。 
@ self.rect.x = self.x 


def blitme(self) : 
--Snip-- 


在 @ 处 ， 给 ship 类 添加 属性 settings ， 以 便 能 够 在 update() 中 
使 用 它 。 鉴 于 现在 调整 飞船 的 位 置 时 ， 将 增 减 一 个 单位 为 像素 的 小 
数值 ， 因 此 需要 将 位 置 赋 给 一 个 能 够 存储 小 数值 的 变量 。 可 使 用 小 


数 来 设置 rect 的 属性 ， 但 rect 将 只 存储 这 个 值 的 整数 部 分 。 为 准 
确 存 储 飞 船 的 位 置 ， 定 义 一 个 可 存储 小 数值 的 新 属性 self.x 〈 见 
人 @) 。 使 用 函数 float() 将 self.rect.x 的 值 转换 为 小 数 ， 并 将 
结果 赋 给 self .x 。 


现在 在 update() 中 调整 飞船 的 位 置 时 ， 将 self.x 的 值 增 减 
settings.ship_speed 的 值 ( 见 @) 。 更 新 self.x 后 ， 再 根据 
它 来 更 新 控制 飞船 位 置 的 self.rect.x ( 见 @) 。self.rect.x 
只 存储 self.x 的 整数 部 分 ， 但 对 显示 飞船 而 言 ， 这 问题 不 大 。 


现在 可 以 修改 ship_speed 的 值 了 。 只 要 它 的 值 大 于 1， 飞 船 的 移 

动 速度 就 会 比 以 前 更 快 。 这 有 助 于 让 飞船 的 反应 速度 足够 快 ， 以 便 

射 杀 外 星人 人， 还 让 我 们 能 够 随 着 游戏 的 进行 加 快 游戏 的 节 委 。 
注意 ”如果 你 使 用 的 是 macOS， 可 能 发 现 即便 ship_speed 的 
值 很 大 ， 飞 船 的 移动 速度 还 是 很 慢 。 要 修复 这 种 问题 ， 可 在 全 
屏 模 式 下 运行 游戏 ， 我 们 稍 后 就 将 实现 这 种 功能 。 


12.6.5 限制 飞船 的 活动 范围 


当前 ， 如 果 玩 家 按 住 箭头 键 的 时 间 足 够 长 ， 飞 船 将 飞 到 屏幕 之 外 ， 
消失 得 无 影 无 踪 。 下 面 来 修复 这 种 问题 ， 让 飞 朋 到 达 屏 幕 边 缘 后 停 
止 移动 。 为 此 ， 将 修改 Ship 类 的 方法 update() : 


ship.py 


def update( self ): 
"根据 移动 标志 调整 飞船 的 位 置 。 


# 更 新 飞船 a 


if self.moving right and self.rect.right «< self.screen rect. 


self.x += self.settings.ship_ speed 
if self.moving left and self.rect.left > 6: 
self.x -= self.settings.ship_ speed 


# 根据 self.x 更 新 rect 对 象 。 


self.rect.x = self.x 


上 述 代码 在 修改 self.x 的 值 之 前 检查 飞船 的 位 

置 。self.rect.right 返回 飞船 外 接 和 矩形 右边 缘 的 z 坐标 。 如 果 
这 个 值 小 于 self.screen_rect.right 的 值 ， 就 说 明 飞 船 未 触及 
屏幕 右边 缘 〈( 见 @) 。 左 边缘 的 情况 与 此 类 似 : 如 果 rect 左边 缘 
的 z 坐标 大 于 零 ， 就 说 明 飞 船 未 触及 屏幕 左边 缘 〈( 见 @) 。 这 确保 
仅 当 飞船 在 屏幕 内 时 ， 才 调整 self.x 的 值 。 


如 果 此 时 运行 alien_invasion.py， 飞 骨 将 在 触及 屏幕 左边 缘 或 右边 缘 
后 停止 移动 。 真 是 太 神 奇 了 ! 只 在 if 语句 中 添加 一 个 条 件 测试 ， 
就 让 飞 山 在 到 达 屏 幕 左 右边 绿 时 像 被 墙 挡 住 了 一 样 。 


12.6.6 ” 重 构 _check_events() 

随 着 游戏 的 开发 ， 方 法 _check_events() 将 越 来 越 长 。 因 此 将 其 

部 分 代码 放 在 两 个 方法 中 ， 其 中 一 个 处 理 KEYDOWN 事件 ， 另 一 个 处 
理 KEYUP 事件 : 


alien_invasion.py 


def check events(self): 
"响应 鼠标 和 按键 事件 。""" 


for event in pygame.event.get() : 
if event .type == pygame.QUIT : 
sys.exit() 
elif event.type == pygame .KEYDOWN: 
self. check keydown_ events(event) 
elif event.type == pygame.KEYUP: 
self. check_ keyup_events(event) 


def =heek Aeydowns events(self, event): 
“" 啊 应 按键 。""" 

if event.key == pygame.K_RIGHT : 
self.ship.moving right = True 

elif event.key == pygame.K_LEFT: 
self.ship.moving left = True 


def eheck _keyup_ events (self, event ) : 
"响应 松 开 。， 

if event .key == pygame.K_RIGHT : 
self.ship.moving right = False 

elif event .key == pygame.K_LEFT : 
self.ship.moving left = False 


我 们 创建 了 两 个 新 的 辅助 方法 : _check_keydown_events() 和 
_check_keyup_events() 。 它 们 都 包含 形 参 self 和 event 。 这 
两 个 方法 的 代码 是 从 _check_events() 中 复制 而 来 的 ， 因 此 将 方 
法 _check_events() 中 相应 的 代码 蔡 换 成 了 对 这 两 个 新 方法 的 调 
用 。 现 在 ， 方 法 _ check_events() 更 简单 ， 代 码 结构 也 更 清晰 ， 
在 其 中 响应 玩家 输入 时 将 更 容易 。 


12.6.7” 按 Q 键 退出 


能 够 高 效 地 啊 应 按键 后 ， 我 们 来 添加 另 一 种 退出 游戏 的 方式 。 当 

前 ， 每 次 测试 新 功能 时 ， 都 需要 单 击 游戏 窗口 顶部 的 X 按 钮 来 结束 

0 因此 ， 我 们 来 添加 一 个 结束 游戏 的 键盘 快 
和 一 Q 键 ， 


alien_invasion.py 


def check keydown events(self, event): 
--Snip-- 
elif event.key == pygame.K_LEFT : 


self.ship.moving left = True 
elif event .key == pygame.K_q: 
sys.exit() 


在 _check_keydown_events() 中 ,添加 一 个 代码 块 ， 用 于 在 玩家 
按 Q 键 时 结束 游戏 。 现 在 测试 该 游戏 时 ， 你 可 按 Q 键 来 结束 游戏 ， 
而 无 须 使 用 鼠标 将 窗口 关闭 。 


12.6.8 在 全 屏 模 式 下 运行 游戏 

Pygame 文 持 全 屏 模 式 ， 你 可 能 会 更 喜欢 在 这 种 模式 下 而 非常 规 窗 
口中 运行 游戏 。 有 些 游戏 在 全 屏 模式 下 看 起 来 更 舒服 ， 而 在 macOS 
系统 中 用 全 屏 模 式 运 行 会 提升 性 能 。 

要 在 全 屏 模 式 下 运行 该 游戏 ， 可 在 ”init () 中 做 如 下 修改 : 


alien_invasion.py 


def _ init (self): 
"" "初始 化 游戏 并 创建 游戏 资源 。""" 
pygame.init() 
self.settings = Settings() 


self.screen = pygame.display.set mode((6@, 60), pygame.FULLSCR 
self.settings.screen width = self.screen.get rect().width 
self.settings.screen height = self.screen.get rect().height 
pygame.display.set caption("Alien Invasion") 


创建 屏幕 时 ， 传 入 了 尺寸 (6，6) 以 及 参数 pygame .FULLSCREEN 

( 见 @) 。 这 让 Pygame 生 成 一 个 覆盖 整个 显示 器 的 屏幕 。 由 于 无 
法 预先 知道 屏幕 的 宽度 和 高 度 ， 要 在 创建 屏幕 后 更 新 这 些 设置 〈 见 
四 ) : 使 用 屏幕 的 rect 的 属性 width 和 height 来 更 新 对 

象 settings 。 


如 琳 你 喜欢 这 区 游戏 在 全 屏 模式 下 的 外 观 和 行为 ， 请 保留 这 些 设 


置 。 如 果 你 更 喜欢 这 款 游戏 在 独立 的 窗口 中 运行 ， 可 恢复 到 原来 采 
用 的 方法 一 一 将 屏幕 太 寸 设置 为 特定 的 值 。 


注意 ”在 全 屏 模式 下 运行 这 球 游戏 之 前 ， 请 确认 能 够 按 Q 键 退 
出 ， 因 为 Pygame 默 认 不 提供 在 全 屏 模式 下 退出 游戏 的 方式 。 


12.7 简单 回顾 


下 一 节 将 添加 射击 功能 ， 为 此 需要 新 增 一 个 名 为 bullet.py 的 文件 ， 
并 修改 一 些 既 有 文件 。 当 前 有 三 个 文件 ， 其 中 包含 很 多 类 和 方法 。 
添加 其 他 功能 之 前 ， 先 来 回顾 一 下 这 些 文件 ， 让 你 清楚 这 个 项 目的 
组 织 结构 。 


12.7.1 alien_invasion.py 


主 文件 alien_invasion.py 包 含 AlienInvasion 类 。 这 个 类 创建 一 系 
列 贯 罕 整 个 游戏 都 要 用 到 的 属性 : 赋 给 self.settings 的 设置 ， 
赋 给 screen 中 的 主 显示 surface， 以 及 一 个 飞船 实例 。 这 个 模块 还 
含 游戏 的 主 循环 ， 即 一 个 调用 _check_events () 
、ship.update() 和 _ update_screen() 的 while 循环 。 


方法 _check_events() 检测 相关 的 事件 〈 如 按 下 和 松 开 键盘 ) ， 
并 通过 调用 方法 _check_keydown_events() 和 
_Ccheck_keyup_events() 处 理 这 些 事件 。 当 前 ， 这 些 方法 负责 管 
理 飞 船 的 移动 。AlienInvasion 类 还 包含 方法 _update_screen() 
， 访 方法 在 每 次 主 循环 中 重 绘 屏 幕 


要 玩 游 戏 《 外 星人 入 侵 》， 只 需 运 行文 件 alien_invasion.py， 其 他 文 
件 〈settings.py 和 ship.py) 包含 的 代码 会 被 导入 这 个 文件 中 。 


12.7.2 Settings.py 


文件 settings.py 包 含 Settings 类 ， 这 个 类 只 包含 方法 _ init__() 
， 用 于 初始 化 控制 游戏 外 观 和 飞船 速度 的 属性 。 


12.7.3 ship.py 


文件 ship.py 包 含 Ship 类 ， 这 个 类 包含 方法 ”init () 、 管 理 飞 船 
位 置 的 方法 update() 和 在 屏幕 上 绘制 飞船 的 方法 plitme() 。 表 
示 飞 船 的 图 像 存 储 在 文件 夹 images 下 的 文件 ship.bmp 中 。 


动手 试 一 斌 


练习 12-3: Pygame 文 档 ”你 在 编写 游戏 的 道路 上 走 了 很 远 ， 
可 能 想 看 看 Pygame 文 档 。 目 前 ， 只 需 大 致 浏览 一 下 文档 即 

呆 。 在 完成 本 半 项 目的 过 程 中 ， 不 需要 参阅 这 些 文档 ， 但 如 末 
你 想 修 改 游戏 《外 星人 入 侵 》 或 编写 目 己 的 游戏 ， 这 些 文档 将 
会 有 所 帮助 。 


练习 12-4: 火 区 ”编写 一 个 游戏 ， 它 在 屏幕 中 央 显 示 一 个 火 
第 ， 而 玩家 可 使 用 四 个 方向 键 上 下 左右 移动 火 第 。 请 务必 确保 
火 稍 不 会 移 到 屏幕 外 面 。 


练习 12-5: 按键 ”创建 一 个 程序 ， 它 显示 一 个 空 屏幕 。 在 事件 
循环 中 ， 每 当 检 测 到 pygame .KEYDOWN 事件 时 都 打印 属 
ey 。 运 行 这 个 程序 并 按 各 种 键 ， 看 看 Pygame 如 何 
HM。 


12.8 ”射击 

下 面 来 添加 射击 功能 。 我 们 将 编写 在 玩家 按 空 格 键 时 发 射 子弹 (用 
小 矩形 表示 ) 的 代码 。 子 弹 将 在 屏幕 中 向 上 飞行 ， 抵 达 屏 幕 上 边缘 
后 消失 。 

12.8.1 添加 子弹 设置 


首先 ， 更 新 settings.py， 在 方法 _init () 末尾 存储 新 类 Bullet 
所 需 的 值 : 


settings.py 


def init (self): 
--Snip-- 
# 子弹 设置 
self.bullet speed = 1.6 
self.bullet_width 3 
self.bullet height = 15 
self.bullet color = (606, 606, 608) 


0 高 15 像 素 的 深 灰 色 子 弹 。 子 弹 的 速度 比 飞 
哲 和 低 。 


12.8.2 ”创建 Bullet 类 
下 面 来 创建 存储 Bullet 类 的 文件 bullet.py， 其 前 半 部 分 如 下 : 


bullet.py 


import pygame 
from pygame.sprite import Sprite 


class Bullet(Sprite): 
“"" 管 理 飞船 所 发 射 子弹 的 类 """ 


def init (self, ai game): 


"在 飞船 当前 位 置 创建 一 个 子弹 对 象 。""" 
super(). init () 

self.screen = ai game.screen 
self.settings = ai game.settings 
self.color = self.settings.bullet color 


# 在 (6,8) 处 创建 一 个 表示 子弹 的 矩形 ， 再 设置 正确 的 位 置 。 


© self.rect = pygame.Rect(60, 80, self.settings.bullet width, 
self.settings.bullet height) 
@ self.rect.midtop = ai game.ship.rect.midtop 


# 存储 用 小 数 表 示 的 子弹 位 置 。 
[3 self.y = float(self.rect.y) 


Bullet 类 继承 了 从 模块 pygame .sprite 导入 的 Sprite 类 。 通 过 
使 用 精灵 〈sprite) ， 可 将 游戏 中 相关 的 元 素 编 组 ， 进 而 同时 操作 
编组 中 的 所 有 元 系 。 为 创建 子弹 实例 ，__init_() 需要 当前 的 
AlienInvasion 实例 ， 我 们 还 调用 了 super() 来 继承 Sprite 。 另 


外 ， 我 们 还 定义 了 用 于 存储 屏幕 以 及 设置 对 象 和 子弹 颜色 的 属性 。 


在 @ 处 ， 创 建 子弹 的 属性 rect 。 子 弹 并 非 基 于 图 像 ， 因 此 必须 使 

用 pygame.Rect() 类 从 头 开 始 创建 一 个 矩形 。 创 建 这 个 类 的 实例 

时 ， 必 须 提供 矩形 左上 角 的 z 坐标 和 7 坐标 ， 以 及 和 托 形 的 宽度 和 高 

度 。 我 们 在 (0, 0) 处 创建 这 个 矩形， 但 下 一 行 代码 将 其 移 到 了 正确 的 
位 置 ， 因 为 子弹 的 初始 位 置 取决 于 飞船 当前 的 位 置 。 子 弹 的 宽度 和 
高 度 是 从 self.settings 中 获取 的 。 


在 @ 处 ， 将 子弹 的 rect .midtop 设置 为 飞船 的 rect.midtop 。 这 
样子 弹 将 从 飞船 顶部 出 发 ， 看 起 来 像 是 从 飞船 中 射出 的 。 我 们 将 子 
弹 的 y 坐标 存储 为 小 数值 ， 以 便 能 够 微调 子弹 的 速度 ( 见 @) 。 


下 面 是 bullet.py 的 第 二 部 分 ， 包 括 方法 update() 和 
draw_bullet(): 


bullet.py 


def update(self) : 
""" 疝 上 移动 子弹 。""" 
# 更 新 表示 子弹 位 置 的 小 数值 。 


@ self.y -= self.settings.bullet speed 
# 更 新 表示 子弹 的 rect 的 位 置 。 
@ self.rect.y = self.y 


def draw_ bullet(self): 
""" 在 屏幕 上 绘制 子弹 。""" 


@ pygame.draw.rect(self.screen, self.color, self.rect) 


方法 update( ) 管理 子弹 的 位 置 。 发 射出 去 后 ， 子 弹 向 上 移动 ， 意 
味 着 其 y 坐标 将 不 断 减 小 。 为 更 新 子弹 的 位 置 ， 从 self.y 中 减 去 


settings .bullet_speed 的 值 ( 见 @)， 。 接 下 来 ， 
将 self.rect.y 设置 为 self.y 的 值 ( 见 @) 。 


属性 bullet_speed 让 我 们 能 够 随 着 游戏 的 进行 或 根据 需要 提高 子 
弹 的 速度 ， 以 调整 游戏 的 行为 。 子 弹 发 射 后 ， 其 z 坐标 始终 不 变 ， 
因此 子弹 将 沿 直 线 垂 直 向 上 飞行 。 


需要 绘制 子弹 时 ， 我 们 调用 draw_bullet() 。draw.rect() 函数 
使 用 存储 在 self.color 中 的 颜色 填充 表示 子弹 的 rect 占据 的 屏幕 
部 分 ( 见 @@) 。 


12.8.3 ”将 子弹 存储 到 编组 中 


定义 Bullet 类 和 必要 的 设置 后 ， 便 可 编写 代码 在 玩家 每 次 按 空 格 
键 时 都 射出 一 发 子弹 了 。 我 们 将 在 AlienInvasion 中 创建 一 个 编 

组 〈group) ， 用 于 存储 所 有 有 效 的 子弹 ， 以 便 管 理发 射出 去 的 所 

有 子弹 。 这 个 编组 是 pygame.sprite.Group 类 的 一 个 实 

例 。pygame.sprite.Group 类 似 于 列表 ， 但 提供 了 有 助 于 开发 游 
戏 的 额外 功能 。 在 主 循环 中 ， 将 使 用 这 个 编组 在 屏幕 上 绘制 子弹 以 
及 更 新 每 颖 子弹 的 位 置 。 


首先 ， 在 _init__() 中 创建 用 于 存储 子弹 的 编组 : 


alien_invasion.py 


def _ init (self): 
--Snip-- 
self.ship = Ship(self) 


self.bullets = pygame.sprite.Group() 


然后 在 while 循环 中 更 新 子弹 的 位 置 : 
alien_invasion.py 


def run_ game(self): 
""" 开 始 游戏 主 循环 。""" 
while True: 
self. check events() 


self.ship.update() 
self.bullets.update() 
self. update screen() 


对 编组 调用 update() 时 ( 见 @) ， 编 组 自动 对 其 中 的 每 个 精灵 调 
用 update() 。 因 此 代码 行 bullets.update() 将 为 编组 bullets 
中 的 每 颗 子 弹 调用 bullet.update() 。 


12.8.4 开火 


在 AlienInvasion 中 ， 需 要 修改 _check_keydown_events() ， 
以 便 在 玩家 按 空 格 键 时 发 射 一 颗 子 弹 。 无 须 修 

改 _check_keyup_events() ， 因 为 玩家 松 开 空格 键 时 什么 都 不 会 
发 生 。 还 需要 修改 _update_screen() ， 确 保 在 调用 fl1ip() 前 在 
屏幕 上 重 绘 每 颗 子 弹 。 


为 发 射 子弹 ， 需 要 做 的 工作 不 少 ， 因 此 编写 一 个 新 方法 
_fire_bullet() 来 完成 这 项 任务 : 


alien_invasion.py 


--Snip-- 
from ship import Ship 
@ from bullet import Bullet 


class AlienInvasion: 
--Snip-- 


def check keydown events(self, event): 


--Snip-- 
elif event .key == pygame.K qd: 
sys.exit() 
@ elif event.key == pygame.K_SPACE : 


self. fire bullet() 


def check keyup_ events(self, event): 
--Snip-- 


def fire bullet(self) : 


"" "创建 一 果子 弹 ， 并 将 其 加 入 编组 bullets 中 。""" 
日 new_bullet = Bullet(self) 
@ self.bullets.add(new_ bullet) 


def update screen(self): 

""" 更 新 屏幕 上 的 图 像 ， 并 切换 到 新 屏幕 。""" 
self.screen.fill(self.settings.bg color) 
self.ship.blitme() 

9 for bullet in self.bullets.sprites() : 
bullet.draw bullet() 
pygame.display.flip() 
--Snip-- 


首先 导入 Bullet 类 ( 见 @) ， 再 在 玩家 按 空格 键 时 调 

用 fire_bullet() 〈 见 @@) 。 在 fire_bullet() 中 ， 创 建 一 
个 Bullet 实例 并 将 其 赋 给 new_bullet ( 见 @) ， 再 使 用 方法 

add( ) 将 其 加 入 编组 bullets 中 【〈 见 四 ) 。 方 法 add() 类 似 于 

append() ， 不 过 是 专门 为 Pygame 编 组 编写 的 。 


方法 bullets .sprites() 返回 一 个 列表 ， 其 中 包含 编组 bullets 
中 的 所 有 精 录 。 为 在 屏幕 上 绘制 发 射 的 所 有 子弹 ， 人 遍历 编 组 
bullets 中 的 精灵 ， 并 对 每 个 精灵 调用 draw_bullet() 〈 见 
四) . 


如 果 此 时 运行 alien_invasion.py， 将 能 够 左右 移动 飞 附 ， 并 发 射 任 意 
数量 的 子弹 。 子 弹 在 屏幕 上 同上 飞行 ， 抵 达 屏 磊 顶 部 后 消失 得 无 影 
a. 如 图 12-3 所 示 。 你 可 在 settings.py 中 修改 子弹 的 尺寸 、 颜 色 和 
速度 。 


全 
图 12-3 飞 般 发射 一 系列 子弹 后 的 《外 星人 入 侵 》 游 戏 


12.8.5 ”删除 消失 的 子弹 


当前 ， 子 弹 在 抵达 屏 大 顶端 后 消失 ， 但 这 仪 仅 是 因为 Pygame 无 法 
在 屏幕 外 面 绘制 它们 。 这 些 子弹 实际 上 依然 存在 ， 其 y 坐标 为 负数 
且 越 来 越 小 。 这 是 个 问题 ， 因 为 它们 将 继续 消耗 内 存 和 处 理 能 


需要 将 这 些 消失 的 子弹 删除 ， 舍 则 游戏 所 做 的 无 请 工作 将 越 来 越 
多 ， 进 而 变 得 越 来 越 慢 。 为 此 ， 需 要 检测 表示 子弹 的 rect 的 
bottom 属性 是 否 为 零 。 如 果 是 ， 则 表明 子弹 已 飞 过 屏 医 顶端 : 


alien_invasion.py 


def run_game(self) : 
”"" 开 始 游戏 主 循环 。""" 
while True : 
self. check events() 
self.ship.update() 
self.bullets.update() 


# 删除 消失 的 子弹 。 
for bullet in self.bullets.copy() : 
if bullet.rect.bottom <= 6: 
self.bullets.remove(bullet) 
print(len(self.bullets)) 


G@oe@e ee 


self. update screen() 


使 用 for 循环 遍历 列表 (或 Pygame 编 组 时，Python 要 求 该 列表 的 
长 度 在 整个 循环 中 保持 不 变 。 因 为 不 能 从 for 循环 过 历 的 列表 或 编 
组 中 删除 元 素 ， 所 以 必须 遍历 编组 的 副本 。 我 们 使 用 方法 copy() 
来 设置 for 循环 ( 见 @) ， 从 而 能 够 在 循环 中 修改 bullets 。 我 们 
检查 每 颗 子 弹 ， 看 看 它 是 否 从 屏幕 顶端 消失 《〈 见 和 四) 。 如 果 是 ， 就 
将 其 从 bullets 中 删除 ( 见 @) 。 在 @@ 处 ， 使 用 函数 调用 print() 
显示 当前 还 有 多 少 颗 子 弹 ， 以 核实 确实 删除 了 消失 的 子弹 。 


如 傈 这些 代 码 没 有 问题 ， 我 们 及 射 子弹 后 碍 看 终端 窗口 时 ， 将 发 现 
随 看 子弹 一 颗 颗 地 在 屏 硕 顶端 消失 ， 子 弹 数 将 逐渐 降 为 零 。 运 行 该 
游戏 并 确认 子弹 被 正确 删除 后 ， 请 将 这 个 函数 调用 print() 删除 。 
如 宁 不 删除 ， 游 戏 的 速度 将 大 大 降低 ， 因 为 将 得 出 写 入 终端 花 宽 的 
时 间 比 将 图 形 绘制 到 游戏 窗口 花费 的 时 间 还 要 多 。 


12.8.6 ”限制 子弹 数量 

很 多 射击 游戏 对 可 同时 出 现在 屏幕 上 的 子弹 数量 进行 了 限制 ， 以 鼓 
en 目标 地 射击 。 下 面 在 游戏 《外 星人 入 侵 》 中 做 这 样 的 限 

| 。 


首先 ， 在 settings.py 中 存储 最 大 子弹 数 : 


Settings.py 


# 子弹 设置 


--Snip-- 
self.bullet color = (606, 606, 608) 
self.bullets allowed = 3 


这 将 未 消失 的 子弹 数 限制 为 三 颗 。 在 AlienInvasion 的 
_fire_bullet() 中 ， 在 创建 新 子弹 前 检查 未 消失 的 子弹 数 是 否 小 
于 该 设置 : 


alien_invasion.py 


def fire bullet(self): 
""" 创 建新 子弹 并 将 其 加 入 编组 bullets 中 。""" 
if len(self.bullets) < self.settings.bullets allowed: 


new_bullet = Bullet(self) 
self.bullets.add(new bullet) 


玩家 按 空格 键 时 ， 我 们 检查 bullets 的 长 度 。 如 果 len(bullets) 
小 于 3， 就 创建 一 颗 新 子弹 ;但 如 果 有 三 颗 未 消失 的 子弹 ， 则 玩家 
0 如 果 现 在 运行 这 个 游戏 ， 屏 幕 上 最 多 
只 能 二 机 弹 。 


12.8.7 ”创建 方法 _ update _bullets() 


编写 并 检查 子弹 管理 代码 后 ， 可 将 其 移 到 一 个 独立 的 方法 中 ， 确 保 
AlienInvasion 类 组 织 有 序 。 为 此 ， 创 建 一 个 名 

为 _update_bullets() 的 新 方法 ， 并 将 其 放 

在 _update_screen() 前 面 : 


alien_invasion.py 


def update bullets(self): 
""" 更 新 子弹 的 位 置 并 删除 消失 的 子弹 。""" 
# 更 新 子弹 的 位 置 。 
self.bullets.update() 


# 删除 消失 的 子弹 。 


for bullet in self.bullets.copy(): 
if bullet.rect.bottom <= 6: 
self.bullets.remove(bullet) 


_update_bullets() 的 代码 是 从 run_game() 剪 切 并 粘贴 而 来 
的 ， 这 里 只 是 让 注释 更 清晰 了 。 


run_game() 中 的 while 循环 又 变 得 简单 了 : 
alien_invasion.py 


while True: 
self. check events() 
self.ship.update() 


self. update bullets() 
self. update screen() 


我 们 让 主 循环 包含 尽 可 能 少 的 代码 ， 这 样 只 要 看 方法 名 就 能 迅速 知 
道 游戏 中 发 生 的 情况 。 主 循环 检查 玩家 的 输入 ， 并 更 新 飞船 的 位 置 
和 所 有 未 消失 子弹 的 位 置 。 然 后 ， 使 用 更 新 后 的 位 置 来 绘制 新 屏 
各。 


请 再 次 运行 alien_invasion.py， 确 认 发 射 子弹 时 没有 错误 。 
动手 试 一 试 

练习 12-6: 侧面 射击 ”编写 一 个 游戏 ， 将 一 稻 飞 险 放 在 屏幕 
左 侧 ， 并 允许 玩家 上 下 移动 飞船 。 在 玩家 按 空格 键 时 ， 让 飞船 


发 射 一 箱 在 屏幕 中 回 右 飞行 的 子弹 ， 并 在 子弹 从 屏幕 中 消失 后 
将 其 删除 。 


12.9 ”小结 


在 本 章 中 ， 你 学 习 了 : 游戏 开发 计划 的 制定 ， 以 及 使 用 Pygame 编 
写 的 游戏 的 基本 结构 ;如 何 设置 背景 色 ， 以 及 如 何 将 设置 存储 在 独 
芯 的 类 中 ， 以 便 轻 松 调整 ， 如 何在 屏幕 上 绘制 图 像 ， 以 及 如 何 让 玩 
家 控制 游戏 元 系 的 移动 ， 创建 自动 移动 的 元 素 ， 如 在 屏 副 中 同上 飞 
行 的 子弹 ， 以 及 删除 不 再 需要 的 对 象 ， 如 何 定期 重 构 项 目的 代码 ， 
为 后 续 开发 提供 便利 。 


在 第 13 章 中 ， 我 们 将 在 游戏 《外 星人 人 入侵》 中 添加 外 星人 。 到 第 13 
章 结束 时 ， 你 将 能 够 击落 外 星人 一 一 但 愿 是 在 其 撞 到 飞船 之 前 ! 


革 ”外 星人 来 了 


2 本 章 将 在 游戏 《外 星人 入 侵 》 中 添加 外 星人 。 我 
们 将 首先 在 屏幕 上 边 纤 附近 添加 让 外 星人 人 ， 再 生成 一 群 外 星 
人 。 然 后 让 这 群 外 星人 向 两 边 和 下 面 移 动 ， 并 删除 被 子弹 击 中 
的 外 星人 人。 最后， 显示 玩家 拥有 的 飞 骨 数量 ， 并 在 玩家 的 飞 骨 
用 完 后 结束 游戏 。 


通过 阅读 本 章 ， 你 将 更 深入 地 了 解 Pygame 和 大 型 项 目 管理 ， 

还 将 学 习 如 何 检测 游戏 对 象 之 间 的 碰撞 ， 如 子弹 和 外 星人 之 间 
的 碰撞 。 检 测 碰撞 有 助 于 定义 游戏 元 素 之 间 的 交互 。 例 如 ， 可 
以 将 角色 限定 在 迷宫 墙壁 之 内 ， 或 者 在 两 个 角色 之 间 传 球 。 我 
们 将 不 时 查看 游戏 开发 计划 ， 确 保 编程 工作 不 偏离 轨道 


痢 手 编写 在 屏幕 上 添加 一 群 外 星人 的 代码 前 ， 先 来 回顾 一 下 这 
个 项 目 ， 并 更 新 开发 计划 。 


13.1 项 目 回顾 


开发 大 型 项 目 时 ， 要 在 进入 每 个 开发 阶段 之 前 回顾 一 下 开发 计划 ， 
搞 清楚 接 下 来 要 通过 编写 代码 来 完成 哪些 任务 。 本 章 涉及 以 下 内 
容 。 


。 研究 既 有 人 代码， 确定 实现 新 功能 前 是 人 否 要 重 构 。 

。 在 屏幕 左上 和 角 添加 一 个 外 星人 ， 并 指定 合适 的 边 距 。 

。 根据 第 一 个 外 星人 的 边 距 和 屏幕 尺寸 计算 屏幕 上 可 容纳 多 少 个 
On 

六 部 分 。 

。 让 外 星人 群 回 两 边 和 下 方 移 动 ， 直 到 外 星人 被 全 部 击落 、 有 人 外 
星人 撞 到 飞船 或 有 外 星人 抵达 屏 闫 底 端 。 如 果 整 群 外 星人 都 被 
击落 ， 将 再 创建 一 群 外 星人 。 如 果 有 外 星人 撞 到 了 飞船 或 抵达 
屏幕 确 端 ， 将 销毁 飞船 并 再 创建 一 群 外 星人 。 

I 


我 们 将 在 实现 功能 的 同时 完善 这 个 计划 ， 但 就 目前 而 言 ， 该 计划 已 
足够 详尽 。 


在 项 目 中 添加 新 功能 前 ， 还 应 审核 既 有 代码 。 每 进入 一 个 新 阶段 ， 
项 目 通 常会 更 复杂 ， 因 此 最 好 对 混乱 或 低 效 的 代码 进行 清理 。 我 们 
一 直 在 不 断 重 构 ， 因 此 当前 没有 需要 重 构 的 代码 。 


13.2 创建 第 一 个 外 星人 

在 屏幕 上 放置 外 星人 与 放置 飞艇 类 似 。 每 个 外 星人 的 行为 都 

由 Alien 类 控制 ， 我 们 将 像 创建 ship 类 那样 创建 这 个 类 。 出 于 简 
化 考虑 ， 也 将 使 用 位 图 来 表示 外 星人 。 你 可 以 自己 寻找 表示 外 星人 
的 图 像 ， 也 可 以 使 用 如 图 13-1 所 示 的 图 像 ， 它 可 在 本 书 配套 资源 
(ituring.cn/book/2784)〉 中 找到 。 这 幅 图 像 的 背景 为 灰色 ， 与 屏幕 
彰 景 色 一 致 。 请 务必 将 选择 的 图 像 文件 保存 到 文件 夹 images 中 。 


图 13-1 用 来 创建 外 星人 群 的 外 星人 图 像 


13.2.1 创建 Alien 类 
下 面 来 编写 Alien 类 并 将 其 保存 为 文件 alien.py: 


alien.py 


import pygame 
from pygame.sprite import Sprite 


class Alien(Sprite): 
"" "表示 单个 外 星人 的 类 


def _ init (self, ai game): 
"初始化 外 星人 并 设置 其 起 始 位 置 。""" 
super()._ init__() 
self.screen = ai game.screen 


# 加 载 外 星人 图 像 并 设置 其 rect 属 性 
self.image = pygame.image.1load('images/alien.bmp') 
self.rect = self.image.get_ rect() 


# 每 个 外 星人 最 急 都 在 屏幕 左上 和 角 附近 。 
© self.rect.x = self.rect.width 
self.rect.y = self.rect.height 


# 存储 外 星人 的 精确 水 平 位 置 。 


@ self.x = float(self.rect.x) 


除 位 置 不 同 外 ， 这 个 类 的 大 部 分 代码 与 Ship 类 相似 。 每 个 外 星人 
最 初 都 位 于 屏幕 左上 角 附 近 。 将 每 个 外 星人 的 左边 距 都 设置 为 外 星 
人 的 宽度 ， 并 将 上 边 距 设置 为 外 星人 的 高 度 〈 见 @) ， 这 样 更 容易 
看 清 。 我 们 主要 关心 的 是 外 星人 的 水 平 速度 ， 因 此 精确 地 记录 了 每 
个 外 星人 的 水 平 位 置 ( 见 @) 。 


Alien 类 不 需要 一 个 在 屏幕 上 绘制 外 星人 的 方法 ， 因 为 我 们 将 使 用 
一 个 Pygame 编 组 方法 ， 目 动 在 屏幕 上 绘制 编组 中 的 所 有 元 素 。 


13.2.2 ”创建 Alien 实例 


要 让 第 一 个 外 星人 在 屏幕 上 现 身 ， 需 要 创建 一 个 Alien 实例 。 这 属 
于 设置 工作 ， 因 此 将 把 这 些 代 码 放 在 AlienInvasion 类 的 方法 

_ init_ () 末尾 。 我 们 最 终 会 创建 一 群 外 星人 ， 涉 及 的 工作 量 不 
少 ， 因 此 将 新 建 一 个 名 为 _create_fleet() 的 辅助 方法 。 

在 类 中 ， 方 法 的 排列 顺序 无 关 紧 要 ， 只 要 按 统一 的 标准 排列 就 行 。 
我 们 将 把 _create_fleet() 放 在 _update_screen() 前 面 ， 不 过 
放 在 AlienInvasion 类 的 任何 地 方 其 实 都 可 行 。 首 先 ， 需 要 导 

入 Alien 类 。 

下 面 是 alien_invasion.py 中 修改 后 的 ijmport 语句 : 


alien_invasion.py 


--Snip-- 
from bullet import Bullet 


from alien import Alien 


下 面 是 修改 后 的 方法 _ init__(): 


alien_invasion.py 


def _ init (self): 
--Snip-- 
self.ship = Ship(self) 
self.bullets = pygame.sprite.Group() 


self.aliens = pygame.sprite.Group() 


self. create fleet() 


创建 了 一 个 用 于 存储 外 星人 群 的 编组 ， 还 调用 了 接 下 来 将 编写 的 方 
法 _create fleet() 。 


下 面 是 新 编写 的 方法 _ create _ fleet() : 
alien_invasion.py 


def create fleet(self): 
"创建 外 星人 群 。""" 
# 创建 一 个 外 星人 。 


alien = Alien(self) 
self.aliens.add(alien) 


在 这 个 方法 中 ， 创 建 了 一 个 Alien 实例 ， 再 将 其 添加 到 用 于 存储 外 
星人 和 群 的 编组 中 。 外 星人 默认 放 在 屏幕 左上 角 附 近 ， 对 第 一 个 外 星 
人 来 说 ， 这 样 的 位 置 非常 合适 。 


要 让 外 星人 现 身 ， 需 要 在 _update_screen() 中 对 外 星人 编组 调用 
方法 draw() : 


alien_invasion.py 


def update screen(self): 
--Snip-- 
for bullet in self.bullets.sprites(): 
bullet.draw_ bullet() 


self.aliens.draw(self.screen) 


pygame.display.flip() 


对 编组 调用 draw( ) 时 ，Pygame 将 把 编组 中 的 每 个 元 素 绘制 到 属 
性 rect 指定 的 位 置 。 方 法 draw( ) 接受 一 个 参数 ， 这 个 参数 指定 了 
要 将 编组 中 的 元 素 绘 制 到 哪个 surface 上 。 图 13-2 显 示 了 在 屏幕 上 现 
吴 的 第 一 个 外 星人 。 


图 13-2 第 一 个 外 星人 现 身 
第 一 个 外 星人 正确 地 现 身 了 ， 下 面 来 编写 绘制 一 群 外 星人 的 代码 。 


13.3 创建 一 群 外 星人 


要 绘制 一 群 外 星人 ， 需 要 确定 一 行 能 容纳 多 少 个 外 星人 以 及 要 绘制 
多 少 行 。 我 们 将 首先 计算 外 星人 的 水 平 间距 并 创建 一 行 外 星人 ， 再 
确定 可 用 的 垂直 空间 并 创建 整 群 外 星人 。 


13.3.1 确定 一 行 可 容纳 多 少 个 外 星人 


为 确定 一 行 可 容纳 多 少 个 外 星人 ， 来 看 看 可 用 的 水 平 空间 有 多 大 。 
屏幕 宽度 存储 在 settings .screen width 中 ， 但 需要 在 屏幕 两 边 
都 留 下 一 定 的 边 距 《〈 将 其 设置 为 外 星人 的 宽度 ) 。 因 为 有 两 个 边 
人 


available space x = settings.screen width - (2 * alien width) 


还 需要 在 外 星人 之 间 留 出 一 定 的 空间 ， 不 妨 将 其 定 为 外 星人 的 宽 

度 。 因 此 ， 显 示 一 个 外 星人 所 需 的 水 平 空 间 为 外 星人 宽度 的 两 倍 : 
一 个 宽度 用 于 放置 外 星人 ， 劝 一 个 览 度 为 外 星人 右边 的 空 日 区 域 。 
为 确定 一 行 可 容纳 多 少 个 外 星人 ， 将 可 用 空间 除 以 外 星人 宽度 的 两 
倍 。 我 们 使 用 整除 (floor division〉 运 算 符 // ， 它 将 两 个 数 相 除 并 
丢弃 余数 ， 让 我 们 得 到 一 个 表示 外 星人 个 数 的 整数 。 


number _ aliens x = available space x // (2 * alien width) 


我 们 将 在 创建 外 星人 群 时 使 用 这 些 公式 。 


注意 ” 令 人 欣慰 的 是 ， 在 程序 中 执行 计算 时 ， 无 须 在 一 开始 
确定 公式 是 正确 的 ， 而 是 可 以 党 试 运行 程序 ， 看 看 结 采 是 个 符 
合 预期 。 即 便 是 在 最 坏 的 情况 下 ， 也 只 是 屏幕 上 显示 的 外 星人 
太 多 或 太 少 。 随 后 可 根据 在 屏幕 上 看 到 的 情况 调整 计算 公式 。 


13.3.2 创建 一 行 外 星人 


现在 可 以 创建 整 行 外 星人 了 。 由 于 创建 单个 外 星人 的 代码 管用 ， 我 
们 重 写 _create_fleet() 使 其 创建 一 行 外 星人 : 


alien_invasion.py 


def create fleet(self): 
"" "创建 外 星人 群 。""" 
# 创建 一 个 外 星人 并 计算 一 行 可 容纳 多 少 个 外 星人 。 
# 外 星人 的 间距 为 外 星人 宽度 。 
alien = Alien(self) 
alien width = alien.rect.width 
available space x = self.settings.screen width - (2 * alien_ 
number aliens x = available space x // (2 * alien width) 


# 创建 第 一 行 外 星人 。 
for alien number in range(number aliens x): 
# 创建 一 个 外 星人 并 将 其 加 入 当前 行 。 
alien = Alien(self) 
alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.X 


self.aliens.add(alien) 


这 些 代 码 大 多 在 前 面 详细 介绍 过 。 为 放置 外 星人 ， 需 要 知道 外 星人 
的 宽度 和 高 度 ， 因 此 在 执行 计算 前 ， 创 建 一 个 外 星人 见 @) .这 
个 外 星人 不 是 外 星人 群 的 成 员 ， 因 此 没有 将 其 加 入 编组 aliens 
中 。 在 全 处 ， 从 外 星人 的 rect 属性 中 获取 外 星人 宽度 ， 并 将 这 个 
值 存储 到 alien_width 中 ， 以 免 反 复 访问 属性 rect 。 在 全 处 ， 计 
算 可 用 于 放置 外 星人 的 水 平 空间 以 及 其 中 可 容纳 多 少 个 外 星人 。 


接 下 来 ， 编 写 一 个 循环 ， 从 零 数 到 要 创建 的 外 星人 数 《〈 见 @@) . 在 
这 个 循环 中 ， 创 建 一 个 新 的 外 星人 ， 并 通过 设置 z 坐标 将 其 加 入 当 
前 行 〈 见 加 ) .将 每 个 外 星人 都 往 右 推 一 个 外 星人 宽度 。 接 下 来 ， 

将 外 星人 宽度 乘 以 2， 得 到 每 个 外 星人 占据 的 空间 《其 中 包括 右边 
的 空白 区 域 ) ， 再 据 此 计算 当前 外 星人 在 当前 行 的 位 置 。 我 们 使 用 
外 星人 的 属性 x 来 设置 其 rect 的 位 置 。 最 后 ， 将 每 个 新 创建 的 外 

星人 都 添加 到 编组 aliens 中 。 


如 果 现 在 运行 这 个 游戏 ， 将 看 到 第 一 行 外 星人 ， 如 图 13-3 所 示 。 


会 
图 13-3 ”第 一 行 外 星人 


这 行 外 星人 在 屏幕 上 稍微 偏向 了 左边 、 这 实际 上 是 有 好 处 的 ， 因 为 
后 面 将 让 外 星人 群 往 右 移 ， 触 及 屏幕 边缘 后 稍微 往 下 移 ， 再 往 左 

移 ， 依 此 类 推 。 就 像 经 典 游戏 《太空 入 侵 者 》， 相 比 于 只 往 下 移 ， 
这 种 移动 方式 更 为 有 趣 。 我 们 将 让 外 星人 群 不 断 这 样 移动 ， 直 到 所 
有 外 星人 都 被 击落 ， 或 者 有 外 星人 撞 上 飞船 或 抵达 屏幕 底 端 。 


注意 ”根据 所 选择 的 屏幕 宽度 ， 在 你 的 系统 中 ， 第 一 个 外 星 
人 的 位 置 可 能 稍 有 不 同 。 


13.3.3 ” 重 构 _ create _fleet() 


倘 徊 只 需 使 用 前 面 的 代码 就 能 创建 外 星人 群 ， 也 许 应 该 让 
_create_fleet() 保持 原样 ， 但 鉴于 创建 外 星人 群 的 工作 还 未 完 
成 ， 我 们 稍微 整理 一 下 这 个 方法 。 为 此 ， 添 加 辅助 方法 
_create alien() ， 并 在 _create fleet() 中 调用 它 : 


alien_invasion.py 


def create fleet(self): 
--Snip-- 
# 创建 第 一 行 外 星人 。 
for alien number in range(number aliens x): 
self. create alien(alien number) 


def create alien(self, alien number): 


"" "创建 一 个 外 星人 并 将 其 放 在 当前 行 。""" 


alien = Alien(self) 

alien width = alien.rect.width 

alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 

self.aliens.add(alien) 


除 self 外 ， 方 法 _create_alien() 还 接受 另 一 个 参数 ， 即 要 创建 
的 外 星人 的 编号 。 该 方法 的 代码 与 _create_fleet() 相同 ， 但 在 
内 部 获取 外 星人 宽度 ， 而 不 是 将 其 作为 参数 传 入 。 这 样 重 构 后 ， 添 
加 新 行进 而 创建 整 群 外 星人 将 更 容易 。 


13.3.4 ”添加 行 


要 创建 外 星人 和 群 ， 需 要 计算 屏幕 可 容纳 多 少 行 ， 并 将 创建 一 行 外 星 
人 的 循环 重复 执行 相应 的 次 数 。 为 计算 可 容纳 的 行 数 ， 要 先 计算 可 
用 的 垂直 空间 : 用 屏幕 高 度 减 去 第 一 行 外 星人 的 上 边 距 《外 星人 高 
人 
Ek 下 请 


available space y = settings.screen height - (3 * alien height) - ship 


这 将 在 飞船 上 方 留 出 一 定 的 空白 区 域 ， 给 玩家 留 出 财 杀 外 星人 的 时 


间 。 


每 行 下 方 都 要 留 出 一 定 的 空白 区 域 ， 不 妨 将 其 设置 为 外 星人 的 高 
度 。 为 计算 可 容纳 的 行 数 ， 将 可 用 的 垂直 空间 除 以 外 星人 高 度 的 两 
信 。 我 们 使 用 整除 ， 因 为 行 数 只 能 是 整数 。 (同样 ， 如 果 这 样 的 计 
算 不 对 ， 我 们 号 上 束 能 发 现 ， 继 而 将 间距 调整 为 合理 的 值 。) 


number_rows = available space y // (2 * alien height) 


知道 可 容纳 多 少 行 之 后 ， 便 可 重复 执行 创建 一 行 外 星人 的 代码 了 : 
alien_invasion.py 


def create fleet(self): 
--Snip-- 
alien = Alien(self) 
alien width, alien height = alien.rect.size 
available space x = self.settings.screen width - (2 * alien_ 
number aliens x = available space x // (2 * alien width) 


# 计 算 屏 幕 可 容纳 多 少 行 外 星人 。 
ship height = self.ship.rect.height 
available space y = (self.settings.screen height - 
(3 * alien height) - ship_height) 
number_rows = available space y // (2 * alien height) 


# 创建 外 星人 群 。 
for row number in range(number_rows): 
for alien number in range(number aliens x): 
self. create alien(alien number, row_number) 


def create alien(self, alien number, row number): 
“" "创建 一 个 外 星人 ， 并 将 其 放 在 当前 行 。""" 
alien = Alien(self) 
alien width, alien height = alien.rect.size 
alien.x = alien width + 2 * alien width * alien number 
alien.rect.x = alien.x 


alien.rect.y = alien.rect.height + 2 * alien.rect.height * r 
self.aliens.add(alien) 


需要 知道 外 星人 的 宽度 和 高 度 ， 因 此 在 @ 人 处 使 用 了 属性 size 。 该 
属性 是 一 个 元 组 ， 包 含 rect 对 象 的 宽度 和 高 度 。 为 计算 屏幕 可 容 
纳 多 少 行 外 星人 ， 在 计算 available_space_x 的 代码 后 面 添加 了 
计算 available_space_y 的 代码 ( 见 @) 。 此 处 将 计算 公式 用 圆 
括号 括 起 来 ， 以 便 将 代码 分 成 两 行 ， 遵 循 每 行 不 超过 79 字 符 的 建 
议 。 


为 创建 多 行 外 星人 ， 使 用 了 两 个 髓 套 在 一 起 的 循环 : 一 个 外 部 循环 
和 一 个 内 部 循环 ( 见 @) 。 内 部 循环 创建 一 行 外 星人 人， 而 外 部 循环 
从 零 数 到 要 创建 的 外 星人 行 数 ， Python 将 重复 执行 创建 单行 外 星人 
的 代码 ， 重 复 次 数 为 number_rows 。 


为 舱 套 循环 ， 编 写 了 一 个 新 的 for 循环 ， 并 缩 进 了 要 重复 执行 的 代 
码 。 (在 大 多 数 文本 编辑 器 中 ， 缩 进 代 码 块 和 取消 缩 进 都 很 容易 ， 

详情 请 参阅 附录 B) 。 现 在 调用 _create _alien() 时 ,传递 了 一 个 
表示 行 号 的 实 参 ， 将 每 行 都 沿 屏幕 依次 同 下 放置 。 


在 _create_alien() 的 定义 中 ， 需 要 一 个 用 于 存储 行 号 的 形 参 。 
在 _create_alien() 中 ， 修 改 外 星人 的 y 坐标 见 @) 并 在 第 一 行 
外 星人 上 方 留 出 与 外 星人 等 高 的 空白 区 域 。 相 邻 外 星人 行 的 y 坐标 
相差 外 星人 高 度 的 两 倍 ， 因 此 将 外 星人 高 度 乘 以 2， 再 乘 以 行 号 。 
第 一 行 的 行 号 为 0， 因 此 第 一 行 的 垂直 位 置 不 变 ， 而 其 他 行 都 沿 屏 
秦 依 次 回 下 放置 。 


如 果 现 在 运行 这 个 游戏 ， 将 看 到 一 群 外 星人 ， 如 图 13-4 所 示 。 


息 Alien Invasion 


图 13-4 整 群 外 星人 都 现 身 了 
下 一 节 将 让 外 星人 群 动 起 来 ! 
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练习 13-1: 星星 找 一 幅 星 星 图 像 ， 并 在 屏幕 上 显示 一 系列 整 
齐 排列 的 星星 。 


练习 13-2: 更 盟 真 的 星星 “为 让 星星 的 分 布 更 允 趴 ， 可 随机 
地 放置 星星 。 本 书 前 面 说 过 ， 可 像 下 面 这 样 来 生成 随机 数 : 


from random import randint 
random number = randint(-106, 106) 


上 述 代码 返回 一 个 -10 和 10 之 间 的 随机 整数 。 在 为 完成 练习 13-1 
而 编写 的 程序 中 ， 随 机 地 调整 每 笑星 星 的 位 置 。 


13.4 让 外 星人 群 移动 


下 面 来 让 外 星人 群 在 屏幕 上 辐 右 移动 ， 撞 到 屏 医 边缘 后 下 移 一 定 的 
量 ， 再 沿 相 反 的 方向 移动 。 我 们 将 不 断 移动 所 有 的 外 星人 ， 直 到 外 
星人 被 全 部 消灭， 或 者 有 外 星人 撞 上 飞船 或 抵达 屏幕 底 闹 。 下 面 先 
让 外 星人 向 右 移动 。 


13.4.1 癌 右 移动 外 星人 群 

为 移动 外 星人 群 ， 将 使 用 alien.py 中 的 方法 update() 。 对 于 外 星人 
I 
» 芭 。 


Settings.py 


def init (self): 
--Snip-- 


# 外 星人 设置 


self.alien speed = 1.6 


再 使 用 这 个 设置 来 实现 update() : 
alien.py 


def _ init (self, ai game): 
"初始 化 外 星人 并 设置 其 初始 位 置 。""" 
super(). init () 
self.screen = ai game.screen 
self.settings = ai game.settings 
--Snip-- 


Update(self) : 

"" "向 右 移动 外 星人 。 

self.x += Self.settings.alien_speed 
self.rect.x = self.x 


在 _init () 中 添加 了 属性 settings ， 以 便 能 够 在 update() 中 
访问 外 星人 的 速度 。 每 次 更 新 外 星人 时 ， 都 将 它 向 右 移动 ， 移 动量 
为 alien_speed 的 值 。 我 们 使 用 属性 self.x 跟踪 每 个 外 星人 的 准 
确 位 置 ， 该 属性 可 存储 小 数值 ( 见 @) 。 然 后 ， 使 用 self.x 的 值 
来 更 新 外 星人 的 rect 的 位 置 ( 见 @) 。 


主 while 循环 中 己 调 用 了 更 新 飞船 和 子弹 的 方法 ， 现 在 还 需 更 调用 
更 新 每 个 外 星人 位 置 的 方法 : 


alien_invasion.py 


while True: 
self. check events() 
self.ship.update() 
self. update bullets() 


self. update aliens() 
self. update screen() 


需要 编写 一 些 代 人 码 来 管理 外 星人 群 的 移动 ， 因 此 新 建 一 个 名 
为 _update_aliens() 的 方法 。 我 们 在 更 新 子弹 后 再 更 新 外 星人 的 
位 置 ， 因 为 稍 后 要 检查 是 否 有 子弹 击 中 了 外 星人 。 


将 这 个 方法 放 在 模块 的 什么 地 方 都 无 关 紧 要 ， 但 为 确保 代码 组 织 有 
序 ， 我 将 它 放 在 方法 update_bullets() 的 后 面 ， 以 便 与 while 
循环 中 的 调用 顺序 一 致 。 下 面 是 _update_aliens() 的 第 一 版 : 


alien_invasion.py 


def update aliens(self): 
""" 更 新 外 星人 群 中 所 有 外 星 


self.aliens.update() 


对 编组 调用 方法 update() ， 这 将 自动 对 每 个 外 星人 调用 方法 
update() 。 如 果 现 在 运行 这 个 游戏 ， 你 将 看 到 外 星人 群 同 右 移 
动 ， 并 在 屏幕 右边 缘 消 失 。 


13.4.2 ”创建 表示 外 星人 移动 方 同 的 设置 


下 面 来 创建 让 外 星人 撞 到 屏 磋 右边 缘 后 同 下 移动 、 再 问 左 移动 的 设 
置 。 实 现 这 种 行为 的 代码 如 下 : 


settings.py 


# 外 星人 设置 
self.alien speed = 1.6 
self.fleet drop speed = 16 


# fleet_direction 为 1 表示 向 右 移 ， 为 -1 表示 向 左 移 。 
self.fleet direction = 1 


设置 fleet_drop_speed 指定 有 外 星人 撞 到 屏幕 边缘 时 ， 外 星人 群 
向 下 移动 的 速度 。 将 这 个 速度 与 水 平 速度 分 开 是 有 好 处 的 ， 便 于 分 
别 调整 这 两 个 速度 。 


要 实现 设置 fleet_direction ， 可 将 其 设置 为 文本 值 ， 如 'left' 
或 'right' ， 但 这 样 就 必须 编写 if-elif 语句 来 检查 外 星人 群 的 移 
动 方向 。 鉴 于 只 有 两 个 可 能 的 方向 ， 我 们 使 用 值 1 和 -1 来 表示 ， 并 
在 外 星人 和 群 改变 方向 时 在 这 两 个 值 之 间 切 换 。“《 回 右 移 时 需要 增 大 
每 个 外 星人 的 z 坐标 ， 而 向 左 移 时 需要 减 小 每 个 外 星人 的 z 坐标 ， 
因此 使 用 数字 来 表示 方向 十 分 合理 。) 


13.4.3 ”检查 外 星人 是 否 报到 了 屏幕 边缘 


现在 需要 编写 一 个 方法 来 检查 外 星人 是 否 撞 到 了 屏幕 边缘 ， 还 需 修 
改 update() 让 每 个 外 星人 都 治 正确 的 方 同 移动 。 这 些 代 码 位 于 
Alien 类 中 : 


alien.py 


def check edges(self): 
"" "如果 外 星人 位 于 屏幕 边缘 ， 就 返回 True。""" 
screen rect = self.screen.get rect() 
© if self.rect.right >= screen rect.right or self.rect.left “= 
return True 


def update(self) : 
“"" 向 左 或 向 右 移动 外 星人 。*"" 
@ self.x += (self.settings.alien speed * 
self.settings.fleet direction) 
self.rect.x = self.x 


可 对 任意 外 星人 调用 新 方法 check_edges() ， 看 其 是 否 位 于 屏幕 
左边 缘 或 右边 缘 。 如 果 外 星人 的 rect 的 属性 right 大 于 或 等 于 屏 


幕 的 rect 的 right 属性 ， 就 说 明 外 星人 位 于 屏幕 右边 缘 ， 如 采 外 
星人 的 rect 的 left 属性 小 于 或 等 于 0， 就 说 明 外 星人 位 于 屏幕 左 
边缘 ( 见 @) 。 


我 们 修改 方法 update() ， 将 移动 量 设置 为 外 星人 速度 和 
fleet_direction 的 乘积 ， 让 外 星人 辣 左 或 回 右 移 动 ( 见 @) 。 
如 果 fleet_direction 为 1， 就 将 外 星人 的 当前 z 坐标 增 

大 alien_speed ， 从 而 将 外 星人 问 右 移 ; 如 果 fleet_direction 
为 -1， 就 将 外 星人 的 当前 z 坐标 减 去 alien_speed ， 从 而 将 外 星人 
向 左 移 。 


13.4.4” 问 下 移动 外 星人 群 并 改变 移动 方 问 


有 外 星人 到 达 屏 幕 边 缘 时 ， 需 要 将 整 群 外 行星 下 移 ， 并 改变 它们 的 
移动 方向 。 为 此 ， 和 需要 在 AlienInvasion 中 添加 一 些 代 码 ， 因 为 
要 在 这 里 检查 是 否 有 外 星人 到 达 了 左边 缘 或 石 边缘 。 我 们 编写 方法 
_Check fleet edges() 和 change fleet direction()， 并 
有 修改 _update_aliens() 。 这 些 新 方法 将 放 

在 _create alien() 后 面 ， 但 其 实 放 在 AlienInvasion 类 中 的 什 
么 位 置 都 无 关 紧 要 : 


alien_invasion.py 


def check fleet edges(self): 


"有 外 星人 到 达 边缘 时 采取 相应 的 措施 。""" 


@ for alien in self.aliens.sprites() : 
if alien.check edges(): 
@ self. change_fleet_ direction() 


break 


def change fleet direction(self): 
"" 将 整 群 外 星人 下 移 ， 并 改变 它们 的 方向 。""" 
for alien in self.aliens.sprites(): 
@ alien.rect.y += self.settings.fleet drop_speed 
self.settings.fleet direction *= -1 


在 _check_fleet_edges() 中 ,遍历 外 星人 群 并 对 其 中 的 每 个 外 
星人 调用 check_edges() ( 见 @) 。 如 果 check_edges() 返回 


True ， 束 表明 相应 的 外 星人 位 于 屏幕 边缘 ， 需要 改变 外 星人 和 群 的 
方 问 ， er _change_fleet direction() 并 退出 循环 〈 见 
四 ) . 在 _ change fleet direction() 中 ,遍历 所 有 外 星人 人， 将 
每 个 外 性 人 下 移 设 置 fleet drop speed 的 值 〈 见 人 全) 。 然 后 ， 
将 fleet_direction 的 值 改 为 其 当前 值 与 -1 的 乘积 调整 外 星人 
群 移动 方向 的 代码 行 没有 包含 在 for 循环 中 ， 因为 我 们 要 调整 攻 每 个 
外 星人 的 垂直 位 置 ， 但 只 想 调整 外 星人 群 移动 方 癌 一 次 。 


下 面 显 示 了 对 _update_aliens() 所 做 的 修改 : 


alien_invasion.py 


def update aliens(self): 


检查 是 否 有 外 星人 位 于 屏幕 边缘 ， 
并 更 新 整 群 外 星人 的 位 置 。 


self. check fleet edges() 
self.aliens.update() 


我 们 将 方法 _update_aliens() 修改 成 了 先 调 
用 _check_fleet_edges() ， 再 更 新 每 个 外 星人 的 位 置 。 


如 末 现 在 运行 这 个 游戏 ， 外 星人 和 群 将 在 屏幕 上 来 回 移动 ， 并 在 抵达 
屏 厌 边缘 后 癌 下 移动 。 现 在 可 以 开始 射 杀 外 星人 ， 并 检查 是 否 有 外 
星人 撞 到 飞 鹏 或 抵达 了 屏 医 撒 咒 


动手 试 一 斌 


练习 13-3: 雨滴 “寻找 一 幅 雨 泣 图 像 ， 并 创建 一 系列 整齐 排列 
的 雨滴 。 让 这 些 雨 滴 往 下 落 ， 直 到 到 达 屏 幕 底 端 后 消失 。 


练习 13-4: 连绵 细 了 十 ”修改 为 完成 练习 11-3 而 编写 的 代码 ， 使 
得 一 行 雨滴 消失 在 屏幕 底 端 后 ， 屏 幕 顶 端 又 出 现 一 行 新 雨滴 并 
开始 往 下 落 。 


13.5 ”刺杀 外 星人 


我 们 创建 了 飞船 和 外 星人 群 ， 但 子弹 击 中 外 星人 时 将 穿 过 外 星人 ， 
因为 还 没有 检查 人 碰撞。 在 游戏 编程 中 ， 倍 撞 指 的 是 游戏 元 素 重 登 
在 一 起 。 要 让 子弹 能 够 击 洲 外 星人 ， 我 们 将 使 

用 sprite.groupcollide() 检测 两 个 编组 的 成 员 之 间 的 倍 撞 。 


13.5.1 检测 子弹 与 外 星人 的 碰撞 


子弹 击 中 外 星人 时 ， 我 们 需要 马上 知道 ， 以 便 碰撞 发 生 后 让 子弹 立 
即 消失 。 为 此 ， 我 们 将 在 更 新 子弹 的 位 置 后 立即 检测 碰撞 。 


函数 sprite.groupcollide() 将 一 个 编组 中 每 个 元 素 的 rect 同 
另 一 个 编组 中 每 个 元 素 的 rect 进行 比较 。 在 这 里 ， 是 将 每 颗 子弹 
的 rect 同 每 个 外 星人 的 rect 进行 比较 ， 并 返回 一 个 字典 ， 其 中 包 
含 发 生 了 碰撞 的 子弹 和 外 星人 。 在 这 个 字典 中 ， 每 个 键 都 是 一 颗 子 
弹 ， 而 关联 的 值 是 被 该 子弹 击 中 的 外 星人 《第 14 章 实现 记分 系统 
时 ， 也 将 使 用 该 字典 ) 。 


在 方法 _update_bullets() 末尾 ， 添 加 如 下 检查 子弹 和 外 星人 碰 
撞 的 代码 : 


alien_invasion.py 


def update bullets(self): 
""" 更 新 子弹 的 位 置 ， 并 删除 消失 的 子弹 。""" 


--Snip-- 


# 检查 是 否 有 子弹 击 中 了 外 星人 


# 如果 是 ， 就 删除 相应 的 子弹 和 外 星人 。 
collisions = pygame.sprite.groupcol1lide( 
self.bullets, self.aliens, True, True) 


这 些 新 增 的 代码 将 self.bullets 中 所 有 的 子弹 都 与 self.aliens 
中 所 有 的 外 星人 进行 比较 ， 看 它们 是 否 重 车 在 一 起 。 每 当 有 子弹 和 
外 星人 的 rect 重 闭 时 ，groupcollide() 就 在 它 返回 的 字典 中 添 


加 一 个 键 值 对 。 两 个 实 参 True 让 Pygame 删 除 发 生 碰 撞 的 子弹 和 外 
星人 。“《 要 模拟 能 够 飞行 到 屏幕 顶端 、 消 灭 击 中 的 每 个 外 星人 的 高 
能 子弹 ， 可 将 第 一 个 布尔 实 参 设 置 为 False ， 并 保留 第 二 个 布尔 参 
数 为 True 。 这 样 被 击 中 的 外 星人 将 消失 ， 但 所 有 的 子弹 都 始终 有 
效 ， 直 到 抵达 屏幕 顶端 后 消失 。) 


如 果 此 时 运行 这 个 游戏 ， 被 击 中 的 外 星人 将 消失 。 如 图 13-5 所 示 ， 
有 些 外 星人 被 射 杀 了 。 


图 13-5 可 以 射 杀 外 星人 了 
13.5.2 ”为 测试 创建 大 子弹 


只 需 运行 这 个 游戏 就 可 测试 很 多 功能 ， 但 有 些 功 能 在 正和 营 情况 下 测 
试 起 来 比较 烦琐 。 例 如 ， 要 测试 代码 能 否 正 确 处 理 外 星人 编组 为 空 
的 情形 ， 需 要 花 很 长 时 间 将 屏 磊 上 的 外 星人 全 部 射 杀 。 


测试 有 些 功 能 时 ， 可 以 修改 游戏 的 茶 些 设置 ， 以 便 能 够 专注 于 游戏 
的 特定 方面 。 例 如 ， 可 以 给 小 屏 医 以 减少 需要 射 杀 的 外 星人 数量 ， 
也 可 以 提高 子弹 的 速度 ， 以 便 能 够 在 单位 时 间 内 发 射 大 量子 弹 。 


测试 这 个 游戏 时 ， 我 喜欢 做 的 一 项 修改 是 ， 增 大 子弹 的 尺寸 并 使 其 
在 击 中 外 星人 后 依然 有 效 ， 如 图 13-6 所 示 。 请 尝试 

将 bullet_width 设置 为 300 乃 至 3000， 看 看 将 所 有 外 星人 全 部 射 
杀 有 多 快 ! 


全 
图 13-6 威力 超 强 的 子弹 让 游戏 的 有 些 方法 测试 起 来 更 容易 


这 样 的 修改 可 提高 测试 效率 ， 还 可 能 激发 出 如 何 赋予 玩家 更 大 威力 
的 思想 火 伦 。《 完 成 测试 后 ， 别 筷 了 将 设置 恢复 正常 。) 


13.5.3 ”生成 新 的 外 星人 和 群 


这 个 游戏 的 一 个 重要 特点 是 ， 外 星人 无 穷 无 尽 : 一 群 外 星人 被 消灭 
后 ， 义 会 出 现 为 一 群 外 星人 。 


要 在 一 群 外 星人 被 消灭 后 再 显示 一 群 外 星人 ， 首 先 需 要 检查 编组 
aliens 是 否 为 空 。 如 果 是 ， 就 调用 _create_fleet() 。 我 们 将 
在 _update_bullets() 末尾 执行 这 项 任务 ， 因 为 外 星人 都 是 在 这 
里 被 消灭 的 : 


alien_invasion.py 


def update bullets(self): 
--Snip-- 
© if not self.aliens : 


# 删除 现 有 的 子弹 并 新 建 一 群 外 星人 。 
@ self.bullets.empty() 
self. create fleet() 


在 @ 处 ， 检 查 编组 aliens 是 否 为 空 。 衬 编组 相当 于 False ， 因 此 
这 是 一 种 检查 编组 是 否 为 空 的 简单 方式 。 如 果 编 组 aliens 为 空 ， 


就 使 用 方法 empty() 删除 编组 中 余下 的 所 有 精灵 ， 从 而 删除 现 有 的 
所 有 子弹 〈 见 人 @) 。 我们 还 调用 了 _create_fleet()， 在 屏幕 上 
重新 显示 一 群 外 星人 。 


Rs 当前 这 群 外 星人 被 消灭 干净 后 ， 将 立刻 出 现 一 群 新 的 外 星 


13.5.4 提高 子弹 的 速度 


如 打 现 在 尝试 在 游戏 中 喘 杀 外 星人 ， 可 能 会 及 现 子弹 的 速度 不 太 合 
适 〈《 有 点 快 或 有 点 慢 ) ， 游 戏 感 不 好 。 当 前 ， 可 通过 修改 设置 让 这 
球 游 戏 更 有 意思 、 更 好 玩 。 


要 修改 子弹 的 速度 ， 可 调整 settings.py 中 bullet_speed 的 值 。 在 我 
的 系统 中 ， 我 把 bullet_speed 的 值 调整 到 1.5， 让 子弹 的 速度 快 
些 ; 


settings.py 


# 子弹 设置 
self.bullet speed 
self.bullet width 
--Snip-- 


1:5 
3 


这 项 设置 的 最 佳 值 取 决 于 你 使 用 的 系统 的 速度 ， 请 找 出 适合 目 己 的 
值 。 你 也 可 以 调整 其 他 设置 。 


13.5.5 ” 重 构 _update_bullets() 


下 面 来 重 构 update_ bullets() ， 使 其 不 再 执行 那么 多 任务 。 为 
此 ， 将 处 理子 弹 和 外 星人 碰撞 的 代码 移 到 一 个 独立 的 方法 中 : 


alien_invasion.py 


def update bullets(self): 
--Snip-- 
# 删除 消失 的 子弹 。 
for bullet in self.bullets.copy(): 
if bullet.rect.bottom <= 6: 
self.bullets.remove(bullet) 


self. check bullet alien collisions() 


def check bullet alien collisions(self): 


"" "响应 子弹 和 外 星人 碰撞 。" 


# 删除 发 生 碰撞 的 子弹 和 外 星人 。 


collisions = pygame.sprite.groupcol1lide( 
self.bullets, self.aliens, True, True) 


if not self.aliens: 
# 删除 现 有 的 所 有 子弹 ， 并 创建 一 群 新 的 外 星人 。 
self.bullets.empty() 
self. create fleet() 


我 们 创建 了 一 个 新 方法 _check_bullet alien collisions()， 

用 于 检测 子弹 和 外 星人 之 间 的 碰撞 ， 并 在 整 群 外 星人 被 消灭 干净 时 
采取 相应 的 措施 。 这 能 避免 update_bullets() 过 长 ， 简 化 了 后 
续 开 发 玉 作 。 


动手 试 一 斌 


练习 13-5: 侧面 射击 2 ”完成 练习 12-6 之 后 ， 我 们 给 游戏 《外 
星人 入 侵 》 添 加 了 很 多 功能 。 在 本 练习 中 ， 请 尝试 让 练习 12-6 
中 飞艇 的 功能 与 当前 《外 星人 入 侵 》 中 的 类 似 。 在 屏幕 右 侧 添 
加 一 群 外 星人 或 让 外 星人 的 位 置 随机 〉， 并 让 其 向 飞船 移 
动 。 男 外 ， 编 写 代码 让 被 子弹 击 中 的 外 星人 消失 。 


13.6 ”结束 游戏 


如 采 玩 家 根本 不 会 输 ， 游 戏 还 有 什么 趣味 和 挑战 性 可 言 ? 如 果 玩 家 
没 能 在 足够 短 的 时 间 内 将 整 群 外 星人 消灭 干将 ， 导 致 有 外 星人 撞 到 
了 飞船 或 抵达 屏 萌 底 端 ， 飞 朋 将 被 摧毁 。 与 此 同时 ， 限 制 玩 家 可 使 
用 的 飞船 数 ， 在 玩家 用 光 所 有 的 飞船 后 ， 游 戏 将 结 


13.6.1 检测 外 星人 和 飞船 碰撞 
首先 检查 外 星人 和 飞船 之 间 的 碰撞 ， 以 便 在 外 星人 撞 上 飞船 时 做 出 


合适 的 响应 。 为 此 ， 在 AlienInvasion 中 更 新 每 个 外 星人 的 位 置 
后 ， 立 即 检测 外 星人 和 飞船 之 间 的 辜 撞 : 


alien_invasion.py 


def update aliens(self): 
--Snip-- 
self.aliens.update() 


# 检测 外 星人 和 飞船 之 间 的 碰撞 。 
if pygame.sprite.spritecollideany(self.ship, self.aliens): 
print("Ship hit!!!") 


印 数 spritecollideany() 接受 两 个 实 参 : 一 个 精灵 和 一 个 编组 。 
它 检查 编组 是 否 有 成 员 与 精灵 发 生 了 碰撞 ， 并 在 找到 与 精灵 发 生 磁 
撞 的 成 员 后 停止 遍历 编组 。 在 这 里 ， 它 遍历 编组 aliens ， 并 返回 
找到 的 第 一 个 与 飞船 发 生 碰 撞 的 外 星人 。 


如 果 没 有 发 生 碰撞 ，spritecollideany() 将 返回 None ， 因 此 @ 
处 的 if 代码 块 不 会 执行 。 如 果 找 到 了 与 飞船 发 生 碰撞 的 外 星人 ， 
它 就 返回 这 个 外 星人 ， 因 此 if 代码 块 将 执行 : 打印 “Ship 

hitlll”( 见 @) 。 有 外 星人 撞 到 飞船 时 ， 需 要 执行 很 多 任务 : 删除 
余下 的 外 星人 和 子弹 ， 让 飞船 重新 居中 ， 以 及 创建 一 群 新 的 外 星 
人 。 编 写 完 成 这 些 任 务 的 代码 之 前 ， 需 要 确定 检测 外 星人 和 飞船 碰 
撞 的 方法 是 否 可 行 。 为 此 ， 最 简单 的 方式 就 是 调用 函数 print() 。 


现在 如 果 运 行 这 个 游戏 ， 则 每 当 有 外 星人 撞 到 飞船 时 ， 终 端 窗口 都 
将 显示 “Ship hitl!1”。 测 试 这 项 功能 时 ， 请 将 alien_drop_speed 设 
置 为 较 大 的 值 ， 如 50 或 100， 这 样 外 星人 将 更 快 地 撞 到 飞船 。 


13.6.2” 啊 应 外 星人 和 飞船 碰撞 

现在 需要 确定 当 外 星人 与 飞船 发 生 碰 撞 时 该 做 些 什 么 。 我 们 不 销毁 
ship 实例 并 创建 新 的 ， 而 是 通过 跟踪 游戏 的 统计 信息 来 记录 飞船 
被 撞 了 多 少 次 (跟踪 统计 信息 还 有 助 于 记分 ) 。 


下 面 来 编写 一 个 用 于 跟踪 游戏 统计 信息 的 新 类 GameStats ， 并 将 其 
保存 为 文件 game_stats.py: 


game_stats.py 


class Gamestats : 
“" "跟踪 游 戏 的 统计 信息 。""" 


def init (self, ai game): 
"初始 化 统计 信息 。""" 


self.settings = ai game.settings 


self.reset stats() 


def reset stats(self): 
"" "初始化 在 游戏 运行 期 间 可 能 变化 的 统计 信息 。""" 
self.ships left = self.settings.ship limit 


在 游戏 运行 期 间 ， 只 创建 一 个 GameStats 实例 ， 但 每 当 玩 家 开始 新 
游戏 时 ， 需 要 重 置 一 些 统计 信息 。 为 此 ， 在 方法 reset_stats() 
中 初始 化 大 部 分 统计 信息 ， 而 不 是 在 _ init__() 中 直接 初始 化 。 
我 们 在 _ init _() 中 调用 这 个 方法 ， 这 样 创建 GameStats 实例 时 
将 受 善 地 设置 这 些 统计 信息 ， 在 玩家 开始 新 游戏 时 也 能 调 

用 reset_stats() 。 


当前 ， 只 有 一 项 统计 信息 ships_left ， 其 值 在 游戏 运行 期 间 不 断 
变化 。 一 开始 玩家 拥有 的 飞船 数 存储 在 settings.py 的 ship_limit 
中 : 


Settings.py 


# 飞船 设置 
self.ship speed 


self.ship limit 


还 需 对 alien_invasion.py 做 些 修改 ， 以 创建 一 个 GameStats 实例 。 
首先 ， 更 新 这 个 文件 开头 的 import 语句 : 


alien_invasion.py 


import sys 
from time import sleep 


import pygame 


from settings import Settings 
from game_stats import GameStats 
from ship import Ship 

--Snip-- 


从 Python 标准 库 的 模块 time 中 导入 函数 sleep() ， 以 便 在 飞船 被 
外 星人 接 到 后 让 游戏 暂停 片刻 。 我 们 还 导入 了 GameStats 。 


接 下 来 ， 在 ”init _() 中 创建 一 个 GameStats 实例 : 


alien_invasion.py 


def _ init (self): 
--Snip-- 
self.screen = pygame.display.set_mode( 
(self.settings.screen width, self.settings.screen height)) 
pygame.display.set caption("Alien Invasion") 


# 创建 一 个 用 于 存储 游戏 统计 信息 的 实例 。 
self.stats = GameStats(self) 


self.ship = Ship(self) 
--Snip-- 


在 创建 游戏 窗口 后 、 定 义 诸如 飞船 等 其 他 游戏 元 素 前 ， 创 建 一 
个 GameStats 实例 。 


有 外 星人 撞 到 飞船 时 ， 将 余下 的 飞船 数 减 1， 创 建 一 群 新 的 外 星 
人 ， 并 将 飞船 重新 放 到 屏 间 确 端的 中 央 。 男 外 ， 让 游戏 暂停 片刻 ， 
0 0 0 3 0 4 


下 面 将 实现 这 些 功 能 的 大 部 分 代码 放 到 新 方法 _ship_hit() 中 。 
在 _update_aliens() 中 ， 将 在 有 外 星人 撞 到 飞船 时 调用 这 个 方 


法 : 
alien_invasion.py 


def ship hit(self): 
"响应 飞船 被 外 星人 挤 到 。"…"" 


# 将 ships_left 减 1。 
self.stats.ships left -= 1 


# 清空 余下 的 外 星人 和 子弹 。 
self.aliens.empty() 
self.bullets.empty() 


# 创建 一 群 新 的 外 星人 ， 并 将 飞船 放 到 屏幕 底 端 的 中 央 。 
self. create fleet() 
self.ship.center ship() 


# 暂停 。 
sleep(6.5) 


新 方法 ship_hit() 在 飞船 被 外 星人 撞 到 时 做 出 啊 应 。 在 这 个 方 
法 中 ， 将 余下 的 飞船 数 减 1( 见 @) ， 再 清空 编组 aliens 和 
bullets ( 见 @) 。 


接 下 来 ， 创 建 一 群 新 的 外 星人 ， 并 将 飞船 居中 ( 见 @) 。 稍 后 将 
在 Ship 类 中 添加 方法 center_ship() 。) 最 后 ， 在 更 新 所 有 元 素 


后 《但 在 将 修改 显示 到 屏幕 前 ) 暂停 ， 让 玩家 知道 飞船 被 撞 到 了 

( 见 四 ) 。 这 里 的 函数 调用 sleep() 让 游戏 暂停 半 秒 钟 ， 让 玩家 能 
够 看 到 外 星人 撞 到 了 飞船 。 函 数 sleep() 执行 完毕 后 ， 将 接着 执行 
方法 _update_screen() ， 将 新 的 外 星人 和 群 绘制 到 屏幕 上 。 


在 _update_aliens() 中 ， 当 有 外 星人 撞 到 飞船 时 ， 不 调用 阔 
数 print() ， 而 调用 _ship_hit(): 


alien_invasion.py 


def update aliens(self): 
--Snip-- 
if pygame.sprite.spritecollideany(self.ship, self.aliens): 


self. ship hit() 


下 面 是 新 方法 center_ship() ， 请 将 其 添加 到 ship.py 的 末尾 : 
ship.py 


def center ship(self): 
""" 让 飞船 在 屏幕 底 端 居中 。"…"" 


self.rect.midbottom = self.screen rect.midbottom 


self.x = float(self.rect.x) 


这 里 像 _ init__() 中 那样 让 飞船 在 屏 磊 抵 端 大 中 。 让 飞船 在 屏 间 
底 端 届 中 后 ， 重 置 用 于 跟踪 飞船 确切 位 置 的 属性 self.x 。 


注意 我们 根本 没有 创建 多 艘 飞船 。 在 整个 游戏 运行 期 间 ， 
只 创建 了 一 个 飞船 实例 ， 并 在 该 飞船 被 撞 到 时 将 其 居中。 统计 
信息 ships_left 指出 玩家 是 否 用 完了 所 有 的 飞船 。 


请 运行 这 个 游戏 ， 射 杀 几 个 外 星人 ， 并 让 一 个 外 星人 撞 到 飞船 。 游 
人 将 出 现 一 群 新 的 外 星人 ， 而 飞船 将 在 屏幕 确 端 后 


13.6.3 有 外 星人 到 达 屏 幕 底 端 


如 果 有 外 星人 到 达 屏 幕 底 端 ， 我 们 将 像 有 外 星人 撞 到 飞 朋 那样 做 出 
响应 。 为 检测 这 种 情况 ， 在 alien_invasion.py 中 添加 一 个 新 方法 : 


alien_invasion.py 


def check aliens bottom(self): 
“"" 检 查 是 否 有 外 星人 到 达 了 屏幕 底 端 。""" 
screen rect = self.screen.get rect() 
for alien in self.aliens.sprites(): 
if alien.rect.bottom >= screen rect.bottom: 


# 像 飞 船 被 撞 到 一 样 处 理 。 
self. ship hit() 
break 


方法 _check_aliens_bottom() 检查 是 否 有 外 星人 到 达 了 屏幕 底 
端 。 到 达 屏 幕 底 端 后 ， 外 星人 的 属性 rect .bottom 大 于 或 等 于 屏 
幕 的 属性 rect .bottom ( 见 @) 。 如 果 有 外 星人 到 达 屏 幕 底 端 ， 
就 调用 _ship_hit() 。 只 要 检测 到 一 个 外 星人 到 达 屏 幕 底 端 ， 束 
无 须 检查 其 他 外 星人 了 ， 因 此 在 调用 _ship_hit() 后 退出 循环 。 


我 们 在 _update_aliens() 中 调用 _check_aliens_bottom() : 
alien_invasion.py 


def update aliens(self): 
--Snip-- 
# 检查 是 否 有 外 星人 撞 到 飞 向 。 
if pygame.sprite.spritecollideany(self.ship, self.aliens): 
self. ship hit() 


# 检查 是 否 有 外 星人 到 达 了 屏幕 底 端 。 


self. check aliens bottom() 


在 更 新 所 有 外 星人 的 位 置 并 检测 是 否 有 外 星人 和 飞船 发 生 人 碰撞 后 调 
用 _check_aliens_bottom()。 现 在 ， 每 当 有 外 星人 接 到 飞船 或 
抵达 屏 希 底 病 时 ， 都 将 出 现 一 群 新 的 外 星人 。 


13.6.4 ”游戏 结束 


现在 这 个 游戏 看 起 来 更 完整 了 ， 但 它 永 远 都 不 会 结束 ， 只 

是 ships_left 不 断 变 成 越 来 越 小 的 负数 。 下 面 在 GameStats 中 添 
加 一 个 作为 标志 的 属性 game_active ， 以 便 在 玩家 的 飞船 用 完 后 
结束 游戏 。 首 先 ， 在 GameStats 类 的 方法 _init () 末尾 设置 这 
个 标志 : 


game_stats.py 


def init (self, ai game): 
--Snip-- 


# 游戏 刚 启动 时 处 于 活动 状态 。 


self.game active = True 


接 下 来 在 _ship_hit() 中 添加 代码 ， 在 玩家 的 飞 般 用 完 后 


将 game_active 设置 为 False : 
alien_invasion.py 


def ship hit(self): 
“"" 响 应 飞船 被 外 星人 撞 到 。""" 
if self.stats.ships left > 0: 
# 将 ships_left 减 1。 
self.stats.ships left - 
--Snip-- 


# 暂停。 
sleep(6.5) 
else : 
self.stats.game active = False 


_ship_hit() 的 大 部 分 代码 没有 变 。 我 们 将 原来 的 代码 都 移 到 了 
一 个 if 语句 块 中 ， 它 检查 玩家 是 否 至 少 还 有 一 舟 飞 了 肌 。 如 果 是 ， 
就 创建 一 群 新 的 外 星人 ， 和 暂停 片刻 ， 再 接着 往 下 执行 。 如 果 玩 家 没 
有 了 飞船 ， 就 将 game_active 设置 为 False 。 


13.7 确定 应 运行 游戏 的 哪些 部 分 


我 们 需要 确定 游戏 的 哪些 部 分 在 任何 情况 下 都 应 运行 ， 哪 些 部 分 仅 
在 游戏 处 于 活动 状态 时 才 运 行 : 


alien_invasion.py 


def run game(self): 
""" 开 始 游戏 主 循环 。""" 
while True: 
self. check events() 


if self.stats.game active: 
self.ship.update() 
self. update bullets() 
self. update aliens() 


self. update screen() 


在 主 循环 中 ， 在 任何 情况 下 都 需要 调用 _check_events() ， 即 便 
游戏 处 于 非 活 动 状态 。 例 如 ， 我 们 需要 知道 玩家 是 否 按 了 Q 键 以 退 
出 游戏 ， 或 者 是 否 单 击 了 关闭 窗口 的 按钮 。 我 们 还 需要 不 断 更 新 屏 
幕 ， 以 便 在 等 待 玩家 是 否 选择 开始 新 游戏 时 修改 屏幕 。 其 他 的 函数 
仅 在 游戏 处 于 活动 状态 时 才 需 要 调用 ， 因 为 游戏 处 于 非 活动 状态 
时 ， 不 用 更 新 游戏 元 素 的 位 置 。 


现在 运行 这 个 游戏 ， 它 将 在 飞船 用 完 后 停止 不 动 。 
动手 试 一 试 
练习 13-6: 游戏 结束 ”在 为 完成 练习 13-5 而 编写 的 游戏 中 ， 记 


录 飞 和 朋 被 撞 到 了 多 少 次 以 及 有 多 少 外 星人 和 被 射 杀 。 确 定 合适 的 
游戏 结束 条 件 ， 并 在 满足 该 条 件 后 结束 游戏 。 


13.8 小结 


在 本 章 中 ， 你 学 习 了 : 如 何在 游戏 中 添加 大 量 相 同 的 元 素 ， 如 创建 
一 群 外 星人 ; 如何 使 用 骨 套 循环 来 创建 元 素 网 格 ， 还 通过 调用 每 个 
元 素 的 方法 update() 移动 了 大 量 元 素 ， 如 何 控制 对 象 在 屏幕 上 移 
动 的 方向 ， 以 及 如 何 响应 事件 ， 如 有 外 星人 到 达 屏 幕 边 缘 ; 如 何 检 
测 和 啊 应 子弹 和 外 星人 页 撞 以 及 外 星人 和 飞船 碰撞 ， 如 何在 游戏 中 
J 以 及 如 何 使 用 标志 game_active 来 判断 游戏 是 否 
结束 。 


在 与 这 个 项 目 相关 的 最 后 一 草 中 ， 我 们 将 添加 一 个 Play 按钮 ， 证 玩 
家 能 够 开始 游戏 ， 以 及 在 游戏 结束 后 重 玩 。 每 当 玩 家 消灭 一 群 外 星 
人 后 ， 我 们 都 将 加 快 游戏 的 节 自 ， 并 添加 一 个 记分 系统 ， 得 到 一 个 
极 具 可 玩 性 的 游戏 ! 


本 章 将 络 束 游戏 《外 星人 入 侵 》 的 开发 。 我 们 会 
添加 一 个 Play 按 钮 ， 用 于 根据 需要 局 动 游戏 以 及 在 游戏 结束 后 
重启 游戏 ， 还 会 修改 这 个 游戏 ， 使 其 随 玩 家 等 级 提高 而 加 快 市 
奏 ， 并 实现 一 个 记分 系统 。 阅 读本 章 后 ， 你 将 掌握 足够 多 的 知 
| 
游戏 。 


14.1 添加 Play 按钮 


本 贡 将 添加 一 个 Play 按钮 ， 它 在 游戏 开始 前 出 现 ， 并 在 游戏 结束 后 
再 次 出 现 ， 让 玩家 能 够 开始 新 游戏 。 

当前 ， 这 个 游戏 在 玩家 运行 alien_invasion.py 时 就 开始 了 。 下 面 让 游 
戏 一 开始 处 于 非 活 动 状态 ， 并 提示 玩家 单 击 Play 按 钮 来 开始 游戏 。 
为 此 ， 像 下 面 这 样 修改 GameStats 类 的 方法 _ init () : 


game_stats.py 


def __init (self, ai -game) : 
"初始 化 统计 信息 
self.settings = a ee 
self.reset stats() 


# 让 游戏 一 开始 处 于 非 活动 状态 。 


self.game active = False 


现在 ， 游 戏 一 开始 将 处 于 非 活 动 状态 ， 待 创建 Play 按钮 后 ， 玩 家 才 
能 开始 游戏 。 
14.1.1 创建 Button 类 
i 我 们 将 编写 一 个 Button 
， 用 于 创建 带 标签 的 实心 矩形 。 你 可 在 游戏 中 使 用 这 些 代 码 来 创 


建生 休 扩 组 下 面 是 Button 类 的 第 一 部 分 ， 请 将 这 个 类 保存 为 文 
件 button.py: 


button.py 


import pygame.font 


class Button : 


@ def ltt _ (self, ai _game， msg): 


"初始 化 按钮 的 属性 。 


self.screen = ai game.screen 
self.screen rect = self.screen.get rect() 


# 设置 按钮 的 尺寸 和 其 他 属性 。 

@ self.width, self.height = 260, 506 
self.button color = (606, 255, ©) 
self.text color = (255, 255, 255) 

[3 self.font = pygame.font.SysFont(None, 48) 


# 创建 按钮 的 rect 对 象 ， 并 使 其 居中 。 
@ self.rect = pygame.Rect(6，6，self.width，self.height) 
self.rect.center = self.screen rect.center 


# 按钮 的 标签 只 需 创建 一 次 。 
9 self. prep msg(msg) 


首先 ， 导 入 模块 pygame .font ， 它 让 Pygame 能 够 将 文本 演 染 到 屏 
幕 上 。 方 法 ”init () 接受 参数 self 、 对 象 ai_game 和 msg ， 其 


中 msg 是 要 在 按钮 中 显示 的 文本 ( 见 @)，。 设 置 按钮 的 尺寸 ( 见 
人 @) ， 再 通过 设置 button_color ， 让 按钮 的 rect 对 象 为 亮 绿 
色 ， 并 通过 设置 text_color 让 文本 为 白色 。 


在 全 处 ， 指 定 使 用 什么 字体 来 演 染 文本 。 实 参 None 让 Pygame 使 用 
默认 字体 ， 而 48 指定 了 文本 的 字号 。 为 让 按钮 在 屏幕 上 居中 ， 创 
建 一 个 表示 按钮 的 rect 对 象 〈 见 加 ) ， 并 将 其 center 属性 设置 为 
屏幕 的 center 属性 。 


Pygame 处 理 文本 的 方式 是 ， 将 要 显示 的 字符 串 泻 染 为 图 像 。 在 全 
处 ， 调 用 了 _prep_msg() 来 处 理 这 样 的 泻 染 。 


_prep_msg() 的 代码 如 下 : 


button.py 


_prep msg(self, msg): 
""" 将 msg 演 染 为 图 像 ， 并 使 其 在 按钮 上 居中 。""" 


self.msg image = self.font.render(msg, True, self.text color 


self.button color) 
self.msg image rect = self.msg image.get rect() 
self.msg image rect.center = self.rect.center 


| | 


方法 _prep_msg() 接受 实 参 self 以 及 要 演 染 为 图 像 的 文本 (msg 
) 。 调 用 font .render() 将 存储 在 msg 中 的 文本 转换 为 图 像 ， 再 
将 该 图 像 存 储 在 self.msg_image 中 ( 见 @) 。 方 法 
font.render() 还 接受 一 个 布尔 实 参 ， 该 实 参 指定 开局 还 是 关闭 
反 锯齿 功能 ( 反 锯 齿 让 文本 的 边缘 更 平滑 ) 。 余 下 的 两 个 实 参 分 别 
是 文本 颜色 和 背景 色 。 我 们 启用 了 反 饮 齿 功 能 ， 并 将 文本 的 背景 
设置 为 按钮 的 颜色 。 【如果 没有 指定 背景 色 ，Pygame 泻 染 文本 时 
将 使 用 透明 背景 。) 


在 全 处 ， 让 文本 图 像 在 按钮 上 居中 : 根据 文本 图 像 创建 一 个 rect 
， 并 将 其 center 属性 设置 为 按钮 的 center 属性 。 


最 后 ， 创 建 方法 draw_button() ， 用 于 将 这 个 按钮 显示 到 屏幕 
上 : 


button.py 


def draw_button(self): 
# 绘制 一 个 用 颜色 填充 的 按钮 ， 再 绘制 文本 。 
self.screen.fill(self.button color, self.rect) 


self.screen.blit(self.msg image, self.msg image_rect) 


我 们 调用 screen.fil1() 来 绘制 表示 按钮 的 矩形 ， 再 调 

用 screen.blit() 并 回 它 传递 一 幅 图 像 以 及 与 该 图 像 相 关联 的 
rect ， 从 而 在 屏幕 上 绘制 文本 图 像 。 至 此 ，Button 类 便 创 建 好 
hr 


14.1.2 ”在 屏幕 上 绘制 按钮 


我 们 将 在 AlienInvasion 中 使 用 Button 类 来 创建 一 个 Play 按钮 。 
首先 ， 更 新 ijmport 语句 : 


alien_invasion.py 


--Snip-- 


from game_stats :import GameStats 
from button import Button 


口 二 


只 需要 一 个 Play 按钮 ， 因 此 在 AlienInvasion 类 的 方法 
_ init_() 中 创建 它 。 可 将 这 些 代 码 放 在 方法 _init_() 的 末 
尾 : 


alien_invasion.py 


def init (self): 
--Snip-- 
self. create fleet() 


# 创建 Play 按 钮 。 
self.play_button = Button(self, "Play") 


这 些 代码 创建 一 个 标签 为 Play 的 Button 实例 ， 但 没有 将 它 显 示 到 
屏幕 上 。 为 显示 该 按钮 ， 在 _update_screen() 对 其 调用 方法 
draw_button() : 


alien_invasion.py 


def update screen(self): 
--Snip-- 
self.aliens.draw(self.screen) 


# 如 果 游 戏 处 于 非 活动 状态 ， 就 绘制 play 按 钮 。 
if not self.stats.game active: 
self.play_button.draw_ button() 


pygame.display.flip() 


为 让 Play 按 钮 位 于 其 他 所 有 屏幕 元 素 上 面 ， 在 绘制 其 他 所 有 游戏 元 
素 后 再 绘制 这 个 按钮 ， 然 后 切换 到 新 屏 医 。 将 这 些 代 码 放 在 一 个 证 
代码 块 中 ， 让 按钮 仪 在 游戏 出 于 非 活 动 状态 时 才 出 现 。 


如 果 现 在 运行 这 个 游戏 ， 将 在 屏 间 中 央 看 到 一 个 Play 按 钮 ， 如 图 14- 
1 所 示 。 


© Alien Invasion 


会 
图 14-1 游戏 处 于 非 活动 状态 时 出 现 的 Play 按钮 
14.1.3 ”开始 游戏 


为 在 玩家 单 击 Play 按钮 时 开始 新 游戏 ， 在 _check_events() 末尾 
添加 如 下 elif 代码 块 ， 以 监视 与 该 按钮 相关 的 鼠标 事件 : 


alien_invasion.py 


def check events(self): 
"响应 按键 和 鼠标 事件 。""" 
for event in pygame.event.get(): 
if event.type == pygame.QUIT: 


--Snip-- 
@ elif event.type == pygame .MOUSEBUTTONDOWN: 
@ mouse_pos = pygame.mouse.get pos() 


3 self. _ check play_button(mouse_pos) 


[L | 


无 论 玩家 单 击 屏幕 的 什么 地 方 ， Pygame 邦 将 检测 到 

个 MOUSEBUTTONDOWN 事件 ( 见 @) ， 但 我 们 只 想 让 这 个 游戏 在 玩 
家 用 鼠标 单 击 Play 按 钮 时 做 出 响应 。 为 此 ， 使 用 了 
pygame.mouse.get_pos() ， 它 返回 一 个 元 组 ， 其 中 包含 玩家 单 
击 时 鼠标 的 z 坐标 和 y 坐标 ( 见 @) 。 我 们 将 这 些 值 传 递 给 新 方法 
_check_play_button() ( 见 @)， 


方法 _check_play_button() 的 代码 如 下 ， 将 它 放 
在 _check_events() 后 面 : 


alien_invasion.py 


def Sheck _play_button(self, mouse _pos) : 
" "在 玩家 单 击 Play 按钮 时 开始 新 游戏 。 
if self.play_button.rect.collidepoint(mouse_pos ) : 


self.stats.game active = True 


这 里 使 用 了 rect 的 方法 collidepoint() 检查 鼠标 单 击 位 置 是 否 
在 Play 按钮 的 rect 内 ( 见 @) 。 如果 是 ， 就 将 game_active 设置 
为 True ， 让 游戏 开始 ! 


至 此 ， 现 在 应 该 能 够 开始 这 个 游戏 了 。 游 戏 结束 时 ， 应 
将 game_active 设置 为 False ， 并 重新 显示 Play 按钮 。 


14.1.4 重 置 游戏 


前 面 编写 的 代码 只 处 理 了 玩家 第 一 次 单 击 Play 按钮 的 情况 ， 而 没有 
处 理 游 戏 结束 的 情况 ， 因 为 没有 重 置 导致 游戏 结束 的 条 件 。 


为 在 玩家 每 次 单 击 Play 按钮 时 都 重 置 游 戏 ， 需 要 重 置 统计 信息 、 删 
I 创建 一 群 新 的 外 星人 并 让 飞船 居中 ， 如 下 
小: 


alien_invasion.py 


def Check _play_button(self，mouse _pos) : 

" "在 玩家 单 击 Play 按钮 时 开始 新 游戏 。 

if self.play_button.rect.collidepoint(mouse_pos ) : 
# 重 置 游戏 统计 信息 。 
self.stats.reset stats() 
self.stats.game active = True 


# 清空 余下 的 外 星人 和 子弹 。 


self.aliens.empty() 
self.bullets.empty() 


# 创建 一 群 新 的 外 星人 并 让 飞船 居中 。 
self. create fleet() 
self.ship.center ship() 


在 @ 处 ， 重 置 游戏 统计 信息 ， 给 玩家 提供 三 艘 新 飞船 。 接 下 来 ， 
将 game_active 设置 为 True 。 这 样 ， 这 个 方法 的 代码 执行 完毕 
后 ， 游 戏 就 将 开始 。 清 空 编组 aliens 和 bullets ( 见 @) ， ”然后 
创建 一 群 新 的 外 星人 并 将 飞船 居中 ( 见 @) 。 


现在 ， 每 当 玩家 单 击 Play 按钮 时 ， 这 个 游戏 都 将 正确 地 重 置 ， 让 玩 
家 想 玩 多 少 次 就 玩 多 少 次 ! 


14.1.5 “将 Play 按钮 切换 到 非 活动 状态 

当前 存在 一 个 问题 : 即便 Play 按钮 不 可 见 ， 玩 家 单 击 其 所 在 的 区 域 
时 ， 游 戏 依然 会 做 出 啊 应 。 游 戏 开 始 后 ， 如 果 玩 家 不 小 心 单 击 了 
Play 按钮 所 处 的 区 域 ， 游 戏 将 重新 开始 ! 


为 修复 这 个 问题 ， 可 让 游戏 仅 在 game_active 为 False 时 才 开 
始 : 


alien_invasion.py 


def check play button(self, mouse -pos) : 


"" 玩 家 单 击 Play 按 钮 时 开始 新 游戏 。 
@ button clicked = self.play_button.rect.collidepoint(mouse po 
@ if button clicked and not self.stats.game active: 
# 重 置 游戏 统计 信息 。 
self.stats.reset stats() 


--Snip-- 


标志 button_clicked 的 值 为 True 或 False ( 见 @) 。 仅 当 玩 家 
单 击 了 Play 按 钮 是 游戏 当前 处 于 非 活 动 状 态 时 ， 游 戏 才 重 新 开始 

( 见 人 @) 。 要 测试 这 种 行为 ， 可 开始 新 游戏 ， 并 不 断 单 击 Play 按钮 
所 在 的 区 域 。 如 果 一 切 都 像 预期 的 那样 工作 ， 单 击 Play 按钮 所 处 的 
区 域 应 该 没有 任何 影响 。 


14.1.6 ”隐藏 鼠标 光标 


为 让 玩家 能 够 开始 游戏 ， 要 让 鼠标 光标 可 见 ， 但 游戏 开始 后 ， 光 标 
只 会 添乱 。 为 修复 这 种 问题 ， 需 要 在 游戏 处 于 活动 状态 时 让 光标 不 
可 见 。 可 在 方法 _ check_play_button() 末尾 的 if 代码 块 中 完成 
这 项 任务 : 


alien_invasion.py 


def check play_button(self, mouse_ pos): 
"" "在 玩家 单 击 play 按 钮 时 开始 新 游戏 。""" 
button clicked = self.play_button.rect.collidepoint(mouse_pos) 
if button clicked and not self.stats.game active: 


--Snip-- 
# 隐藏 鼠标 光标 。 
pygame.mouse.set visible(False) 


通过 向 set visible() 传递 False ， 让 Pygame 在 光标 位 于 游戏 窗 
口内 时 将 其 隐藏 起 来 。 


游戏 结束 后 ， 将 重新 显示 光标 ， 让 玩家 能 够 单 击 Play 按 钮 来 开始 新 
游戏 。 相 关 的 代码 如 下 : 


alien_invasion.py 


def ship hit(self): 
“"" 响 应 飞船 被 外 星人 撞 到 。""" 
if self.stats.ships left > 0: 


--Snip-- 

else: 
self.stats.game active = False 
pygame.mouse.set visible(True) 


在 _ship_hit() 中 ， 在 游戏 进入 非 活 动 状态 后 ， 立 即 让 光标 可 
见 。 关 注 这 样 的 细 市 让 游戏 显得 更 专业 ， 也 让 玩家 能 够 专注 于 玩 游 
戏 而 不 是 去 费力 理解 用 户 界 面 。 


动手 试 一 斌 


练习 14-1: 按 P 键 开始 新 游戏 ”鉴于 游戏 《外 星人 入 侵 》 使 用 
键盘 来 控制 飞船 ， 最 好 也 能 够 让 玩家 通过 按键 来 开始 游戏 。 请 
添加 在 玩家 按 P 键 时 开始 游戏 的 代码 。 也 许 这 样 做 会 有 所 帮 
助 : 将 _check_play_button() 的 一 些 代 码 提 取出 来 ， 放 到 
一 个 名 为 _start_game() 的 方法 中 ， 并 

在 _check_play_button() 和 _check_keydown_events() 中 
调用 这 个 方法 。 


练习 14-2: 射击 练习 ”创建 一 个 窍 形 ， 让 它 在 屏幕 右边 缘 以 

固定 的 速度 上 下 移动 。 然 后 ， 在 屏 厌 元 边缘 创建 一 条 飞 朋 ， 玩 
家 可 上 下 移动 它 来 射击 前 述 算 形 标 靶 。 添 加 一 个 用 于 开始 游戏 
的 Play 按钮 ， 在 玩家 三 次 未 击 中 目标 时 结束 游戏 ， 并 重新 显示 
Play 按钮 ， 让 玩家 能 够 单 击 该 按钮 来 重新 开始 游戏 。 


14.2 ”提高 等 级 


当前 ， 将 整 群 外 星人 消灭 干净 后 ， 玩 家 将 提高 一 个 等 级 ， 但 游戏 的 
难度 没 变 。 下 面 来 增加 一 点 趣味 性 : 每 当 玩 家 将 屏幕 上 的 外 星人 消 
灭 干净 后 ， 都 加 快 游 戏 的 节奏 ， 让 游戏 玩 起 来 更 难 。 


14.2.1 ”修改 速度 设置 
首先 重新 组 织 Settings 类 ， 将 游戏 设置 划分 成 静态 和 动态 两 组 。 


对 于 随 着 游戏 进行 而 变化 的 设置 ， 还 要 确保 在 开始 新 游戏 时 进行 重 
置 。settings.py 的 方法 _init_() 如 下 : 


settings.py 


def init (self): 
" "初始化 游戏 的 静态 设置 。""" 
# 屏 幕 设置 
self.screen width = 12606 
self.screen height = 866 
self.bg color = (236，236，236) 


# 飞船 设 置 
self.ship limit = 3 


# 子弹 设置 
self.bullet width = 3 
self.bullet height = 15 
self.bullet color = 60, 60, 60 
self.bullets allowed = 3 


# 外 星人 设置 
self.fleet drop speed = 16 


# 加 快 游戏 节奏 的 速度 。 
self.speedup scale = 1.1 


self.initialize dynamic settings() 


依然 在 _init__() 中 初始 化 静态 设置 。 在 @@ 处 ， 添 加 设 


置 speedup_scale ， 用 于 控制 游戏 节奏 的 加 快速 度 : 2 表示 玩家 每 
提高 一 个 等 级 ， 游 戏 的 节 委 就 翻 一 倍 ; 1 表示 游戏 节 堵 始终 个 变 。 
将 其 设置 为 1.1 能 够 将 游戏 节 委 提高 到 足够 快 ， 让 游戏 既 有 难度 又 
并 非 不 可 完成 。 最 后 ， 用 和 计生 1 edvnahhtE settingel) 初 
始 化 随 游戏 进行 而 变化 的 属性 ( 见 @) 。 


initialize _ dynamic_settings() 的 代码 如 下 : 


settings.py 


def initialize _dynamic_ settings(self): 
"初始化 随 游戏 进行 而 变化 的 设置 。' 
self.ship speed = 1.5 
self.bullet speed = 3.6 
self.alien speed = 1.6 


# fleet_direction 为 1 表示 向 右 ， 为 -1 表示 问 左 。 
self.fleet direction = 1 


这 个 方法 设置 飞船 、 子 弹 和 外 星人 的 初始 速度 。 随 着 游戏 的 进行 ， 
将 提高 这 些 速度 。 每 当 玩 家 开始 新 游戏 时 ， 都 将 重 置 这 些 速度 。 在 
这 个 方法 中 ， 还 设置 了 fleet direction ， 使 得 游戏 刚 开 始 时 ， 
外 星人 总 是 向 右 移动 。 不 需要 增 大 fleet_drop_speed 的 值 ， 因 为 
外 星人 移动 的 速 束 度 越 快 ， 到 达 屏 幕 确 端 所 需 的 时 间 越 短 。 


为 在 玩家 的 等 级 提高 时 提高 飞 朋 、 子 弹 和 外 星人 的 速度 ， 编 写 一 个 
名 为 increase_speed() 的 新 方法 : 


settings.py 


def increase speed(self): 
"" 提 高 速度 设置 """ 


self.ship speed *= self.speedup scale 


self.bullet speed *= self.speedup scale 
self.alien speed *= self.speedup scale 


为 提高 这 些 游 戏 元 象 的 速度 ， 将 每 个 速度 设置 都 乘 以 


speedup_scale 的 值 。 


在 _check_bullet alien collisions() 中 ， 在 整 群 外 星人 都 被 
消灭 后 调用 increase_speed() 来 加 快 游戏 的 节奏 : 


alien_invasion.py 


def check bullet alien collisions(self): 
--Snip-- 
if not self.aliens: 


# 删除 现 有 的 子弹 并 创建 一 群 新 的 外 星人 。 


self.bullets.empty() 
self. create fleet() 
self.settings.increase speed() 


通过 修改 速度 设置 ship_speed 、alien speed 和 bullet_ speed 
的 值 ， 足 以 加 快 整个 游戏 的 节奏 ! 


14.2.2 重 置 速度 


每 当 玩 家 开始 新 游戏 时 ， 都 需要 将 发 生 了 变化 的 设置 重 置 为 初始 
值 ， 否 则 新 游戏 开始 时 ， 速 度 设 置 将 为 前 一 次 提高 后 的 值 : 


alien_invasion.py 


def check play_ button(self, mouse_ pos): 
“"" 在 玩家 单 击 Play 按钮 时 开始 新 游戏 。""" 
button clicked = self.play_button.rect.collidepoint(mouse_pos) 
if button clicked and not self.stats.game active: 


# 重 置 游戏 设置 。 
self.settings.initialize dynamic settings() 
--Snip-- 


现在 ， 游 戏 《 外 星人 入 侵 》 玩 起 来 更 有 趣 ， 也 更 有 挑战 性 了 。 每 当 
玩家 将 屏幕 上 的 外 星人 消灭 干净 后 ， 游 戏 都 将 加 快 节奏 ， 因 此 难度 
更 大 。 如 果 游 戏 的 难度 提高 得 太 快 ， 可 降 

低 settings .speedup_scale 的 值 ， 如 果 游 戏 的 挑战 性 不 足 ， 可 


稍微 提高 这 个 设置 的 值 。 找 出 这 个 设置 的 最 佳 值 ， 让 难度 的 提高 速 
度 相 对 合理 : 一 开始 的 几 群 外 星人 很 容易 消灭 干净 ， 接 下 来 的 几 和 群 
消灭 起 来 有 一 定 难 度 ， 但 也 不 是 不 可 能 ， 而 要 将 之 后 的 外 星人 群 消 
灭 干净 几乎 不 可 能 。 


动手 试 一 斌 
练习 14-3: 有 一 定 难度 的 射击 练习 以 你 为 完成 练习 14-2 而 做 


的 工作 为 基础 ， 让 标 靶 的 移动 速度 随 游 戏 进行 而 加 快 ， 并 在 玩 
家 单 击 Play 按 钮 时 将 其 重 置 为 初始 值 。 


练习 14-4: 难度 等 级 ”在 游戏 《外 星人 入 侵 》 中 创建 一 组 按 
钮 ， 让 玩家 选择 起 始 难度 等 级 。 每 个 按钮 都 给 Settings 中 的 
属性 指定 合适 的 值 ， 以 实现 相应 的 难度 等 级 。 


14.3 ”记分 


下 面 来 实现 一 个 记分 系统 ， 以 实时 跟 踊 玩 家 的 得 分 ， 并 显示 最 局 得 
分 、 等 级 和 余下 的 飞船 数 。 


得 分 是 游戏 的 一 项 统计 信息 ， 因 此 在 GameStats 中 添加 一 个 score 
性 : 


型 3 


game_stats.py 


class GameStats: 
--Snip-- 
def reset stats(self): 
"" 初 始 化 随 游戏 进行 可 能 变化 的 统计 信息 。""" 


self.ships left = self.ai settings.ship limit 
self.score = 0 


为 在 每 次 开始 游戏 时 都 重 置 得 分 ， 我 们 在 reset_stats() 而 不 
是 _init _() 中 初始 化 score 。 


14.3.1 显示 得 分 


为 企 屏幕 上 显示 得 分 ， 首 先 创 建 一 个 新 类 Scoreboard 。 当前 ， 这 
个 类 只 显示 当前 得 分 ， 但 后 面 也 将 使 用 它 来 显示 最 高 得 分 、 等 级 和 
余下 的 飞船 数 。 下 面 是 这 个 类 的 前 半 部 分 ， 被 保存 为 文件 


scoreboard.py: 


scoreboard.py 


import pygame.font 


class Scoreboard : 
"" 显 示 得 分 信息 的 类 。 NI 


@ def _ init (self, ai game): 
"初始 化 显示 得 分 涉及 的 属性 。""" 


self.screen = ai game.screen 


self.screen rect = self.screen.get_rect() 
self.settings = ai game.settings 
self.stats = ai game.stats 


# 显示 得 分 信息 时 使 用 的 字体 设置 。 


@ self.text color = (36，36，36) 

3 self.font = pygame.font.SysFont(None, 48) 
# 准备 初始 得 分 图 像 。 

@ self.prep_score() 


由 于 Scoreboard 在 屏幕 上 显示 文本 ， 首 先导 入 模块 pygame .font 
。 接 下 来 ,在 _init () 中 包含 形 参 ai _game ， 以 便 访 问 报告 跟 
踪 的 值 所 需 的 对 象 settings 、screen 和 stats ( 见 @) 。 然 后 ， 
设置 文本 颜色 〔 见 @) 并 实例 化 一 个 字体 对 象 ( 见 @) 。 


为 将 要 显示 的 文本 转换 为 图 像 ， 调 用 prep_score() ( 见 @) ， 其 
定义 如 下 : 


scoreboard.py 


def prep_score(self) : 
""" 将 得 分 转换 为 一 幅 泻 染 的 图 像 。""" 
score str = Str(self.stats.score) 
self.score image = self.font.render(score str, True, 
self.text color, self.settings.bg color) 


# 在 屏幕 右上 角 显 示 得 分 。 

self.score rect = self.score image.get rect() 
self.score rect.right = self.screen rect.right - 26 
self.score rect.top = 20 


在 prep_score() 中 ， 将 数值 stats .score 转换 为 字符 串 ( 见 
@) ， 再 将 这 个 字符 串 传递 给 创建 图 像 的 render() 〈( 见 @) 。 为 
0 向 render() 传递 屏幕 背景 色 和 文本 颜 


将 得 分 放 在 屏幕 右上 角 ， 并 在 得 分 增 大 导致 数 变 宽 时 让 其 问 左 延 
伸 。 为 确保 得 分 始终 锚 定 在 屏幕 右边 ， 创 建 一 个 名 为 score_rect 


的 rect ( 见 @) ， 让 其 右边 缘 与 屏幕 右边 缘 相 距 20 像 素 〈 见 
人 @) ， 并 让 其 上 边缘 与 屏幕 上 边缘 也 相距 20 像 素 〈 见 加 ) 。 


接 下 来 ， 创 建 方法 show_score() ， 用 于 显示 泻 染 好 的 得 分 图 像 : 


scoreboard.py 


def show_ scorel(self): 
""" 在 屏幕 上 显示 得 分 。""" 


self.screen.blit(self.score image, self.score rect) 


这 个 方法 在 屏幕 上 显示 得 分 图 像 ， 并 将 其 放 在 score_rect 指定 的 
位 置 。 


14.3.2 ”创建 记分 牌 


为 显示 得 分 ， 在 AlienInvasion 中 创建 一 个 Scoreboard 实例 。 先 
来 更 新 Import 语句 : 


alien_invasion.py 


--Snip-- 
from game_stats :import GameStats 
from scoreboard import Scoreboard 


--Snip-- 


接 下 来 ， 在 方法 _init _() 中 创建 一 个 Scoreboard 实例 : 


alien_invasion.py 


def init (self): 
--Snip-- 
pygame.display.set caption("Alien Invasion") 


# 创建 存储 游戏 统计 信息 的 实例 ， 
# 并 创建 记分 牌 。 
self.stats = GameStats(self) 


ee 


self.sb = Scoreboard(self) 
--Snip-- 


然后 ， 在 _update_screen() 中 将 记分 牌 绘制 到 屏幕 上 : 
alien_invasion.py 


def update screen(self): 
--Snip-- 
self.aliens.draw(self.screen) 


# 显 示 得 分 。 
self.sb.show_ score() 


# 如 果 游 戏 处 于 非 活 动 状态 ， 就 显示 Play 按 钮 。 


--Snip-- 


在 显示 Play 按钮 前 调用 show_score() 。 


如 果 现 在 运行 这 个 游戏 ， 将 在 屏幕 右上 角 看 到 0。〈 当 前， 我 们 只 
想 在 进一步 开发 记分 系统 前 确认 得 分 出 现在 正确 的 地 方 。) 图 14-2 
显示 了 游戏 开始 前 的 得 分 。 


会 
图 14-2 ”得 分 出 现在 屏幕 右上 角 
下 面 来 指定 每 个 外 星人 值 多 少 分 ! 
14.3.3 ”在 外 星人 被 消灭 时 更 新 得 分 
为 在 屏幕 上 实时 显示 得 分 ， 每 当 有 外 星人 被 击 中 时 ， 都 更 新 


stats.score 的 值 ， 再 调用 prep_score() 更 新 得 分 图 像 。 但 在 此 
之 前 ， 需 要 指定 玩家 每 击落 一 个 外 星人 将 得 到 多 少 分 : 


Settings.py 


def initialize dynamic settings(self): 
--Snip-- 


# 记分 
self.alien _ points = 56 


随 着 游戏 的 进行 ， 将 提高 每 个 外 星人 的 分 数 。 为 确保 每 次 开始 新 游 
戏 时 这 个 值 都 会 被 重 置 ， 我 们 
在 initialize_dynamic settings() 中 设置 它 。 


在 _check_bullet alien collisions() 中 ， 每 当 有 外 星人 被 击 
落 时 ， 都 更 新 得 分 : 


alien_invasion.py 


def ehecks bullet alien collisions(self): 
"响应 子弹 和 外 星人 发 生 碰 撞 。 
# 删除 彼此 碰撞 的 子弹 和 外 星人 。 
collisions = pygame.sprite.groupcol1lide( 
self.bullets, self.aliens, True, True) 


if collisions: 
self.stats.score += self.settings.alien points 
self.sb.prep_score() 

--Snip-- 


We Pygame 返 回 一 个 字典 〈collisions ) 。 我 
们 检查 这 个 字典 是 否 存在 ， 如 果 存 在 ， 就 将 得 分 加 上 一 个 外 星人 的 
分 数 〈 见 @) 。 接 下 来 ， 调用 prep_score() 来 创建 一 幅 包 含 最 新 
时 分 的 新 图 像 。 


如 果 现 在 运行 这 个 游戏 ， 得 分 将 不 断 增 加 ! 
14.3.4 重 置 得 分 


当前 ， 仅 在 有 外 星人 被 射 杀 之 后 生成 得 分 。 这 在 大 多 数 情况 下 可 
行 ， 但 从 开始 新 游戏 到 有 外 星人 被 册 杀 之 间 ， 显 示 的 是 上 一 次 的 得 


分 。 


为 修复 这 个 问题 ， 可 在 开始 新 游戏 时 生成 得 分 : 


alien_invasion.py 


def check play_ button(self, mouse pos): 


--Snip-- 

if button clicked and not self.stats.game active: 
--Snip-- 
# 重 置 游戏 统计 信息 。 
self.stats.reset stats() 
self.stats.game active = True 
self.sb.prep_score() 
--Snip-- 


开始 新 游戏 时 ， 我 们 重 置 游戏 统计 信息 再 调用 prep_score() 。 此 


时 生成 的 记分 牌 上 显示 的 得 分 为 零 。 
14.3.5 ”将 消灭 的 每 个 外 星人 都 计 入 得 分 


当前 的 代码 可 能 会 遗漏 一 些 被 消灭 的 外 星人 人。 例如， 如 宁 在 一 次 循 
环 中 ， 有 两 颗 子 弹 击 中 了 外 星人 ， 或 者 因子 弹 较 宽 而 同时 击 中 了 多 
个 外 星人 ， 玩 家 将 只 能 得 到 一 个 外 星人 的 分 数 。 为 修复 这 种 问题 ， 
我 们 来 调整 检测 子弹 和 外 星人 碰撞 的 方式 。 


在 _check bullet alien collisions() 中 ， 与 外 星人 碰撞 的 子 
弹 都 是 字典 co11isions 中 的 一 个 键 ， 而 与 每 种 子弹 相关 的 值 都 是 
一 个 列表 ， 其 中 包含 该 子弹 击 中 的 外 星人 人。 我们 这 历 字 
典 collisions ， 确 保 将 消灭 的 每 个 外 星人 都 计 入 得 分 : 


alien_invasion.py 


def check bullet alien collisions(self): 


--Snip-- 
if collisions: 
for aliens in collisions.values() : 
self.stats.score += self.settings.alien points * len(ali 
self.sb.prep_score() 
--Snip-- 


如 果 字 典 collisions 存在 ， 束 遇 历 其 中 的 所 有 值 。 别 起 了， 每 个 
值 都 是 一 个 列表 ， 包 含 被 同一 条 子弹 击 中 的 所 有 外 星人 。 对 于 每 个 
列表 ， 都 将 其 包含 的 外 星人 数量 乘 以 一 个 外 星人 的 分 数 ， 并 将 结 


加 入 当前 得 分 。 为 测试 这 一 点， 请 将 子弹 宽度 改 为 300 像 素 ， 并 核 
实 得 到 了 其 击 中 的 每 个 外 星人 的 分 数 ， 再 将 子弹 宽度 恢复 正常 值 。 


14.3.6 ”提高 分 数 


鉴于 玩家 每 提高 一 个 等 级 ， 游 戏 者 变 得 更 难 ， 因 此 处 于 较 高 的 等 级 
时 ， 外 星人 的 分 数 应 更 高 。 为 实现 这 种 功能 ， 需 要 编写 在 游戏 节奏 
加 快 时 提高 分 数 的 代码 : 


settings.py 


class Settings: 


""" 存 储 游戏 《外 星人 入 侵 》 的 所 有 设置 的 类 。""" 


def _ init (self): 
--Snip-- 
# 加 快 游 戏 节 胡 的 速度 。 
self.speedup scale = 1.1 
# 外 星人 分 数 的 提高 速度 。 


self.score scale = 1.5 
self.initialize dynamic settings() 


initialize dynamic settings(self): 
--Snip-- 


increase speed(self): 

"" 提 高 速度 设置 和 外 星人 分 数 。""" 
self.ship speed *= self.speedup scale 
self.bullet speed *= self.speedup scale 
self.alien speed *= self.speedup scale 


self.alien points = int(self.alien points * self.score scale 


我 们 定义 了 分 数 的 提高 速度 ， 并 称 之 为 score_scale ( 见 @)。 
较 低 的 节奏 加 快速 度 〈1.1) 让 游戏 很 快 变 得 极 具 挑 战 性 ， 但 为 了 
让 记分 发 生 显著 的 变化 ， 需 要 将 分 数 的 提高 速度 设置 为 更 大 的 值 
(1.5) 。 现 在 ， 在 加 快 游戏 节奏 的 同时 ， 提 高 了 每 个 外 星人 的 分 
数 〈( 见 人 @) 。 为 让 分 数 为 整数 ， 使 用 了 函数 int()。 


为 显示 外 星人 的 分 数 ， 在 Settings 的 方法 increase_speed() 中 
调用 函数 print() : 


Settings.py 


def increase speed(self): 
--Snip-- 
self.alien points = int(self.alien points * self.score scale) 


print(self.alien points) 


现在 每 当 提 高 一 个 等 级 时 ， 你 部 将 在 终端 窗口 看 到 新 的 分 数值 。 


注意 “确认 分 数 在 不 断 增 加 后 ， 一 定 要 删除 调用 函数 print() 
的 代码 ， 否 则 可 能 影响 游戏 的 性 能 ， 分 散 玩 家 的 注意 力 。 


14.3.7 舍 入 得 分 
大 多 数 街 机 风格 的 射击 游戏 将 得 分 显示 为 10 的 整数 倍 ， 下 面 让 记分 


系统 遵循 这 个 原则 。 我 们 还 将 设置 得 分 的 格式 ， 在 大 数 中 添加 用 过 
号 表示 的 千 位 分 隔 符 。 在 Scoreboard 中 执行 这 种 修改 : 


scoreboard.py 


def prep_score(self) : 
""" 将 得 分 转换 为 泻 染 的 图 像 。""" 
rounded score = round(self.stats.score, -1) 
score str = "{:,}".format(rounded score) 


self.score image = self.font.render(score str, True, 
self.text color, self.settings.bg color) 
--Snip-- 


函数 round() 通常 让 小 数 精确 到 小 数 点 后 某 一 位 ， 其 中 小 数位 数 是 
由 第 二 个 实 参 指定 的 。 然 而 ， 如 果 将 第 二 个 实 参 指定 为 负 

数 ，round() 将 舍 入 到 最 近 的 10 的 整数 倍 ， 如 10、100、1000 等 。 
和 加 处 的 代码 让 Python 将 stats.score 的 值 舍 入 到 最 近 的 10 的 整数 
倍 ， 并 将 结果 存储 到 rounded_score 中 。 


在 外 处 ， 使 用 一 个 字符 串 格式 设置 指令 ， 让 Python 将 数值 转换 为 字 
符 串 时 在 其 中 插入 去 号 。 例 如， 输出 为 1,666 ,666 而 不 是 1966666 
。 如 果 现 在 运行 这 个 游戏 ， 看 到 的 得 分 将 是 10 的 整数 倍 ， 即 便 得 分 
很 高 亦 如 此 ， 如 图 14-3 所 示 。 
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图 14-3 ”得 分 为 10 的 整数 倍 ， 并 将 喜 号 用 作 王 分 位 分 隔 符 


14.3.8 ”最 高 得 分 


每 个 玩家 都 想 超 过 游戏 的 最 高 得 分 纪录 。 下 面 来 跟踪 并 显示 最 高 得 
分 ， 给 玩家 提供 要 超越 的 目标 。 我 们 将 最 高 得 分 存储 在 GameStats 
中 : 


game_stats.py 


def _ init (self, ai game): 
--Snip-- 


# 任何 情况 下 都 不 应 重 置 最 高 得 分 。 


self.high score = 6 


因为 在 任何 情况 下 都 不 会 重 置 最 高 得 分 ， 所 以 在 _ init__() 而 不 
是 reset_stats() 中 初始 化 high_score 。 


、 


下 面 来 修改 Scoreboard 以 显示 最 高 得 分 。 先 来 修改 方法 
init (): 


scoreboard.py 


def init (self, ai game): 
--Snip-- 
# 准备 包含 最 高 得 分 和 当前 得 分 的 图 


self.prep_score() 
self.prep_high_score() 


最 高 得 分 将 与 当前 得 分 分 开 显示 ， 因 此 需要 编写 一 个 新 方法 
prep_high_score()， 用 于 准备 包含 最 高 得 分 的 图 像 ( 见 @) 。 


方法 prep_high_score() 的 代码 如 下 : 
scoreboard.py 


def prep_high_score(self) : 
""" 将 最 高 得 分 转换 为 泻 染 的 图 像 。""" 
high score = round(self.stats.high score, -1) 
high_ score str = "{:,}".format(high_score) 
self.high_ score image = self.font.render(high score str, Tru 
self.text color, self.settings.bg color) 


# 将 最 高 得 分 放 在 屏幕 项 部 中 央 。 

self.high score rect = self.high_score_image.get_rect() 
self.high score rect.centerx = self.screen rect.centerx 
self.high score rect.top = self.score rect.top 


将 最 局 得 分 舍 入 到 最 近 的 10 的 整数 倍 ， 并 添加 用 逗号 表示 的 干 分 位 
分 阳 符 〔 见 @)〉 。 然 后 ， 根 据 最 高 得 分 生成 一 幅 图 像 ( 见 人 @) ， 使 
其 水 平 居中 〈 见 @) ， 并 将 其 top 属性 设置 为 当前 得 分 图 像 的 top 
属性 ( 见 @) 。 


现在 ， 方 法 show_score( ) 需要 在 屏幕 石上 角 显 示 当 前 得 分 ， 并 在 
屏 磊 顶部 中 央 显 示 最 高 得 分 : 


scoreboard.py 


def show_score(self) : 
""" 在 屏幕 上 显示 得 分 。""" 
self.screen.blit(self.score image, self.score rect) 


self.screen.blit(self.high score image, self.high score rect) 


为 检查 是 售 诞 生 了 新 的 最 高 得 分 ， 在 Scoreboard 中 添加 一 个 新 方 
法 check_high_score() : 


scoreboard.py 


def check high score(self): 
“"" 检 查 是 否 诞生 了 新 的 最 高 得 分 。""" 
if self.stats.score > self.stats.high score: 
self.stats.high score = Self.stats.score 
self.prep_high _ score() 


方法 check_high_score() 比较 当前 得 分 和 最 高 得 分 。 如 果 当 前 得 
分 更 高 ， 束 更 新 high_score 的 值 ， 并 调用 prep_high_score() 
来 更 新 包含 最 高 得 分 的 图 像 。 


在 _check_bullet alien collisions() 中 ， 每 当 有 外 星人 被 消 
灭 时 ， 都 需要 在 更 新 得 分 后 调用 check_high_score() : 


alien_invasion.py 


def check bullet alien collisions(self): 
--Snip-- 
if collisions: 
for aliens in collisions.values() : 
self.stats.score += self.settings.alien points * len(a 


self.sb.prep_score() 
self.sb.check high score() 
--Snip-- 


如 果 字 典 collisions 存在 ， 就 根据 消灭 了 多 少 外 星人 更 新 得 分 ， 
再 调用 check_high_score() 。 


第 一 次 玩 这 个 游戏 时 ， 当 前 得 分 就 是 最 高 得 分 ， 因 此 两 个 地 方 显示 
的 都 是 当前 得 分 。 但 再 次 开始 该 游戏 时 ， 最 高 得 分 会 出 现在 中 央 ， 
而 当前 得 分 则 出 现在 右边 ， 如 图 14-4 所 示 。 
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图 14-4 ”最 高 得 分 显示 在 屏幕 顶部 中 央 

14.3.9 ”显示 等 级 

为 在 游戏 中 显示 玩家 的 等 级 ， 首 先 需 要 在 GameStats 中 添加 一 个 表 
示 当 前 等 级 的 属性 。 为 确保 每 次 开始 新 游戏 时 都 重 置 等 级 ， 

在 reset_stats() 中 初始 化 它 : 


game_stats.py 


def reset stats(self): 
" "初始 化 随 游 戏 进行 可 能 变化 的 统计 信息 。""" 
self.ships left = self.settings.ship limit 


self.score = 0 
self.level = 


为 了 让 Scoreboard 显示 当前 等 级 ， 在 _ init__() 中 调用 一 个 新 
方法 prep_level(): 


scoreboard.py 


def _ init (self, ai game): 
--Snip-- 
self.prep_high_score() 


self.prep_level() 


prep_level() 的 代码 如 下 : 
scoreboard.py 


def prep level(self): 
“"" 将 等 级 转换 为 演 染 的 图 像 。""" 
level str = str(self.stats.level) 
self.level image = self.font.render(level str, True, 
self.text color, self.settings.bg color) 


# 将 等 级 放 在 得 分 下 方 。 

self.level rect = self.level image.get rect() 
self.level rect.right = self.score rect.right 
self.level rect.top = self.score rect.bottom + 16 


方法 prep_level() 根据 存储 在 stats .level 中 的 值 创建 一 幅 图 像 
( 见 @) ， 并 将 其 right 属性 设置 为 得 分 的 right 属性 ( 见 @) 。 
然后 ， 将 top 属性 设置 为 比 得 分 图 像 的 bottom 属性 大 10 像 素 ， 以 
便 在 得 分 和 等 级 之 间 留 出 一 定 的 空间 ( 见 @@) 。 


还 需要 更 新 show_score() : 


scoreboard.py 


def show score(self): 
""" 在 屏幕 上 显示 得 分 和 等 级 。""" 
self.screen.blit(self.score image, self.score rect) 
self.screen.blit(self.high score image, self.high score rect) 


self.screen.blit(self.level image, self.level rect) 


新 增 的 代码 行 在 屏 大 上 显示 等 级 图 像 。 


我 们 在 _check_bullet alien collisions() 中 提高 等 级 并 更 新 
等 级 图 像 : 


alien_invasion.py 


def check bullet alien collisions(self): 
--Snip-- 
if not self.aliens: 
# 删除 现 有 的 子弹 并 新 建 一 群 外 星人 。 
self.bullets .empty() 
self. create fleet() 


self.settings.increase_ speed() 


# 提高 等 级 。 
self.stats.level += 1 
self.sb.prep_level() 


如 果 整 群 外 星人 都 被 消灭 ， 就 将 stats.1level 的 值 加 1， 并 调 
用 prep_level() 确保 正确 地 显示 了 新 等 级 。 


为 确保 在 开始 新 游戏 时 更 新 等 级 图 像 ， 还 需 在 玩家 单 击 按钮 Play 时 
调用 prep_level(): 


alien_invasion.py 


def check play_ button(self, mouse pos): 
--Snip-- 
if button clicked and not self.stats.game active: 
--Snip-- 


self.sb.prep_score() 
self.sb.prep_level() 
--Snip-- 


这 里 在 调用 prep_score() 后 立即 调用 prep_level() 。 
现在 可 以 知道 到 了 多 少 级 ， 如 图 14-5 所 示 。 
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会 
图 14-5 ”当前 等 级 显示 在 当前 得 分 的 正 下 方 
注意 “在 一 些 经 典 游戏 中 ， 得 分 市 有 标签 ， 如 Score、High 
Score 和 Level。 必 星 没有 是 未 攻 旦 标 丛 ， 游戏 开始 后 ， 每 个 数 


的 含义 将 一 目 了 然 。 要 这 些 标签 ， 只 需 在 Scoreboard 中 
调用 font .render() 前 ， 将 它们 添加 到 得 分 字符 串 中 。 


14.3.10 ”显示 余下 的 飞船 数 

最 后 来 显示 玩家 还 有 多 少 艘 飞船 ， 但 使 用 图 形 而 不 是 数字 。 为 此 ， 
在 屏幕 左上 角 绘 制 飞船 图 像 来 指出 还 余下 多 少 艘 飞船 ， 束 人像 众多 经 
典 的 街机 游戏 中 那样 。 


首先 ， 需 要 让 Ship 继承 Sprite ， 以 便 创 建 飞 船 编组 : 


ship.py 


import pygame 
from pygame.sprite import Sprite 


@ class Ship(Sprite) : 
""" 管 理 飞船 的 类 。""" 


def _ init (self, ai game): 


"初始 化 飞船 并 设置 其 起 始 位 置 。""" 


@ super(). init () 
--Snip-- 


这 里 导入 了 Sprite ， 让 Ship 继承 Sprite ( 见 @)， 并 
在 _init _() 的 开头 调用 super() ( 见 @) 。 


接 下 来 ， 需 要 修改 Scoreboard ， 以 创建 可 供 显 示 的 飞船 编组 。 下 
面 是 其 中 的 ijmport 语句 : 


scoreboard.py 


import pygame.font 
from pygame.sprite import Group 


from ship import Ship 


鉴于 需要 创建 飞船 编组 ， 导 入 Group 和 Ship 类 。 
下 面 是 方法 _ init_(): 
scoreboard.py 
def _ init (self, ai game): 
""" 初 始 化 记录 得 分 的 属性 。""" 


self.ai game = ai game 
self.screen = ai game.screen 


--Snip-- 
self.prep_level() 
self.prep_ships() 


我 们 将 游戏 实例 赋 给 一 个 属性 ， 因 为 创建 飞船 时 需要 用 到 它 。 在 调 
用 prep_level() 后 调用 了 prep_ships() 。 


prep_ships() 的 代码 如 下 : 


scoreboard.py 


def prep_ships(self): 
""" 显 示 还 余下 多 少 艘 飞船 。""" 

self.ships = Group() 

for ship number in range(self.stats.ships left): 
ship = Ship(self.ai game) 


ship.rect.x = 16 + ship number * ship.rect.width 
ship.rect.y = 16 
self.ships.add(ship) 


方法 prep_ships() 创建 一 个 空 编组 self.ships ， 用 于 存储 飞船 
实例 ( 见 @) 。 为 填充 这 个 编组 ， 根 据 玩家 还 有 多 少 艘 飞船 以 相应 
的 次 数 运 行 一 个 循环 〈( 见 人 @) 。 在 这 个 循环 中 ， 创 建新 飞船 并 设置 
其 z 坐标 ， 让 整个 飞船 编组 都 位 于 屏幕 左边 ， 且 每 艘 飞船 的 左边 距 
都 为 10 像 素 ( 见 @) 。 还 将 y 坐标 设置 为 离 屏 幕 上 边缘 10 像 素 ， 让 
所 有 飞船 都 出 现在 屏幕 左上 角 《〈 见 加) 。 最 后 ， 将 每 艘 新 飞船 都 添 
加 到 编组 ships 中 ( 见 @) 。 


现在 需要 在 屏幕 上 绘制 飞 胎 了 : 


scoreboard.py 


def show_ scorel(self): 
""" 在 屏幕 上 绘制 得 分 、 等 级 和 余下 的 飞船 数 。""" 
self.screen.blit(self.score image, self.score rect) 
self.screen.blit(self.high score image, self.high score rect) 


self.screen.blit(self.level image, self.level rect) 
self.ships.draw(self.screen) 


为 在 屏幕 上 显示 飞船 ， 对 编组 调用 draw() 。Pygame 将 绘制 每 艘 飞 


船 。 


为 在 游戏 开始 时 让 玩家 知道 自己 有 多 少 笨 飞 胎 ， 在 开始 新 游戏 时 调 
用 prep_ships() 。 这 是 在 AlienInvasion 的 
_check_play_button() 中 进行 的 : 


alien_invasion.py 


def check play_ button(self, mouse pos): 
--Snip-- 
if button clicked and not self.stats.game active: 
--Snip-- 
self.sb.prep_score() 


self.sb.prep_level() 
self.sb.prep_ships() 
--Snip-- 


还 要 在 飞船 被 外 星人 撞 到 时 调用 prep_ships() ， 从 而 在 玩家 损失 
飞船 时 更 新 飞船 图 像 : 


alien_invasion.py 


def ship hit(self): 
“"" 响 应 飞船 被 外 星人 撞 到 。""" 
if self.stats.ships left > 0: 
# 将 ships_left 减 1 并 更 新 记分 牌 。 
self.stats.ships left -= 


self.sb.prep_ships() 
--Snip-- 


这 里 在 将 ships_left 的 值 减 1 后 调用 prep_ships() 。 这 样 每 次 损 
失 飞 船 后 ， 显 示 的 飞船 数 都 是 正确 的 。 


图 14-6 显 示 了 完整 的 记分 系统 ， 它 在 屏幕 左上 角 指 出 还 余下 多 少 艘 
飞船 。 
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分 
图 14-6 游戏 《外 星人 入 侵 》 的 完整 记分 系统 
动手 试 一 斌 


练习 14-5: 空前 的 最 高 分 ”每 当 玩 家 关闭 并 重新 开始 游戏 
《外 星人 入 侵 》 时 ， 最 高 分 都 将 被 重 置 。 请 这 样 修复 该 问题 : 
调用 sys.exit() 前 将 最 高 分 写 入 文件 ， 并 在 GameStats 中 初 
始 化 最 高 分 时 从 文件 中 读 取 它 。 


练习 14-6: 重 构 ” 找 出 执行 多 项 任务 的 方法 ， 对 其 进行 章 构 ， 
让 代码 高 效 而 有 序 。 例 如 ， 对 于 

_check_ bullet alien collisions()， 将 在 外 星人 群 被 消 
灭 干净 时 开始 新 等 级 的 代码 移 到 一 个 名 

为 start_new_level() 的 方法 中 。 再 例如 ， 对 于 Scoreboard 
的 方法 _init__()， 将 其 中 调用 四 个 不 同方 法 的 代码 移 到 一 
个 名 为 prep_images() 的 方法 中 ， 以 缩短 方法 _ init _()。 
如 果 你 重 构 了 _check_play_button()， 方法 
prep_images() 也 可 简化 _check_play_button() 和 
_start game().。 


注意 重 构 项 目前 ， 请 阅读 附录 D， 了 解 如 果 重 构 时 引入 
了 bug， 如 何 将 项 目 恢复 到 可 正确 运行 的 状态 。 


练习 14-7: 扩展 游戏 《外 星人 入 侵 》 ”和 想 想 如 何 扩展 游戏 
《外 星人 入 侵 》。 例 如 ， 可 以 让 外 星人 也 能 够 向 飞船 射击 ， 也 
可 以 为 飞船 添加 盾牌 ， 使 得 只 有 从 两 边 射 来 的 子弹 才能 摧毁 习 
船 。 另 外 ， 还 可 以 使 用 像 pygame.mixer 这 样 的 模块 来 添加 声 
音效 果 ， 如 爆炸 声 和 射击 声 。 


练习 14-8: 终极 版 侧面 射击 ”模仿 项 目 "“ 外 星人 入 侵 ” 继 续 开 

发 “侧面 射击 ”。 添 加 一 个 Play 按钮 ， 在 适合 的 情况 下 加 快 游 戏 
的 节奏 ， 并 开发 一 个 记分 系统 。 在 开发 过 程 中 ， 务 必 重 构 代 

码 ， 并 寻找 机 会 以 本 章 没 有 介绍 的 方式 定制 该 游戏 。 


14.4 ”小结 


在 本 章 中 ， 你 学 习 了 如 何 创建 用 于 开始 新 游戏 的 Play 按钮 ， 如 何 检 
测 鼠 标 事件 ， 以 及 在 游戏 处 于 活动 状态 时 如 何 隐藏 鼠标 光标 。 你 可 
以 利用 学 到 的 知识 在 游戏 中 创建 其 他 按钮 ， 如 用 于 显示 玩法 说 明 的 
Help 按 钮 。 你 还 学 习 了 如 何 随 游 戏 的 进行 调整 其 节 压 ， 如 何 实现 记 
分 系统 ， 以 及 如 何以 文本 和 非 文本 方式 显示 信息 。 


项 目 2 数据 可 视 化 


第 15 章 生成 数据 


~ 数据 可 视 化 指 的 是 通过 可 视 化 表示 来 探索 数据 。 

它 与 数据 分 析 紧密 相关 ， 而 数据 分 析 指 的 是 使 用 代码 来 探索 
数据 集 的 规律 和 关联 。 数 据 集 可 以 是 用 一 行 代 码 就 能 表示 的 小 
型 数字 列表 ， 也 可 以 是 数 干 兆 字 市 的 数据 。 


漂 死 地 呈现 数据 并 非 仅仅 关于 尝 吏 的 图 片 。 通 过 以 引入 注目 的 
简单 方式 呈现 数据 ， 能 让 观看 者 明白 其 含义 : 发 现 数据 集中 原 
本 未 知 的 规律 和 意义 。 


所 羊 即 便 没 有 超级 计算 机 ， 你 也 能 够 可 袖 化 复杂 的 数据 。 鉴于 
Python 的 高 效 性 ， 使 用 它 在 笔记 本 电脑 上 就 人 决 束 地 案 乏 由 数 
百 万 个 数据 点 组 成 的 数据 集 。 数 据点 并 非 必须 是 数 。 利 用 本 书 
前 半 部 分 介绍 的 基本 知识 ， 也 可 对 非 数值 数据 进行 分 析 。 


在 基因 研究 、 天 气 研究 、 政 治 经 济 分 析 等 众多 领域 ， 人 们 常常 
使 用 Python 来 完成 数据 密集 型 工作 。 数 据 科 学 家 使 用 Python 编 
写 了 一 系列 优秀 的 可 视 化 和 分 析 工 具 ， 其 中 很 多 可 供 你 使 用 。 
最 流行 的 工具 之 一 是 Matplotlib， 它 是 一 个 数学 绘图 库 ， 我 们 
将 使 用 它 来 制作 简单 的 图 表 ， 如 折线 图 和 散 点 图 。 然 后 ， 我 们 
将 基于 随机 漫步 概念 生成 一 个 更 有 趣 的 数据 集 一 一 根据 一 系列 
随机 决策 生成 的 图 表 。 


本 章 还 将 使 用 Plotly 包 ， 它 生成 的 图 表 非 常 适 合 在 数字 设备 上 
显示 。Plotly 生 成 的 图 表 可 根据 显示 设备 的 人 寸 目 动 调 整 大 

小 ， 还 具备 众多 交互 特性 ， 如 在 用 户 将 鼠标 指向 图 表 的 不 同 部 
人 本 章 将 使 用 Plotly 来 分 析 搓 山子 


15.1 安装 Matplotlib 


本 章 将 首先 使 用 Matplotlib 来 生成 几 个 图 表 ， 为 此 需要 使 用 pip 来 安 
装 它 。pip 及 一 个 可 用 于 下 载 并 安 泽 Python 包 的 棕 决 。 请 在 终端 提 
示 符 下 执行 如 下 命令 : 


$ python -m pip install --user matplotlib 


这 个 命令 让 Python 运行 模块 pip ， 并 将 matplotlib 包 添 加 到 当前 

用 户 的 Python 安装 中 。 在 你 的 系统 中 ， 如 果 运 行程 序 或 启动 终端 会 

的 命令 不 是 python ， 而 是 python3 ， 应 使 用 类 似 于 下 面 
命 令 


$ python3 -m pip install --user matplotlib 


注意 ”在 macOS 系 统 中 ， 如 打 这 入 不 官 用 ， 请 尝试 在 不 指定 
标志 --user 的 情况 下 再 次 执行 该 命令 。 


要 查看 使 用 Matplotlib 可 制作 的 各 种 图 表 ， 请 访问 其 官方 网 站 ， 浏 
览 示 例 画 廊 。 通 过 单 击 了 画廊 中 的 图 表 ， 可 查看 生成 它们 的 代码 。 


15.2 绘制 简单 的 折线 图 

下 面 使 用 Matplotlib 绘 制 一 个 简单 的 折线 图 ， 再 对 其 进行 定制 ， 以 
实现 信息 更 丰富 的 数据 可 视 化 效果 。 我 们 将 使 用 平方 数 序列 1、4、 
9、16 和 25 来 绘制 这 个 图 表 。 

只 需 提 供 如 下 的 数 ，Matplotlib 将 完成 其 他 工作 : 

mpl_squares.py 


import matplotlib.pyplot as plt 


squares = [1, 4, 9, 16, 25|] 
@ fig, ax = plt.subplots() 


ax.plot(squares) 


plt. show() 


首先 导入 模块 pyplot ， 并 为 其 指定 别名 plt ， 以 免 反 复 输 
入 pyplot 。【〔 在 线 示 例 大 多 这 样 做 ， 这 里 也 不 例外 。) 模 
块 pyplot 包含 很 多 用 于 生成 图 表 的 函数 。 


我 们 创建 了 一 个 名 为 squares 的 列表 ， 在 其 中 存储 要 用 来 制作 图 表 
的 数据 。 然 后 ， 采 取 了 男 一 种 常见 的 Matplotlib 做 法 一 一 调用 卫 
数 subplots() 〈 见 @) 。 这 个 函数 可 在 一 张 图 片 中 绘制 一 个 或 多 
个 图 表 。 变 量 fig 表示 整 张 图 片 。 变 量 ax 表示 图 片 中 的 各 个 图 

表 ， 大 多 数 情况 下 要 使 用 它 。 


接 下 来 调用 方法 plot() ， 它 尝试 根据 给 定 的 数据 以 有 意义 的 方式 
绘制 图 表 。 函 数 plt .show() 打开 Matplotlib 查 看 器 并 显示 绘制 的 图 
表 ， 如 图 15-1 所 示 。 在 得 看 器 中 ， 你 可 缩放 和 导航 图 形 ， 还 可 单 击 
磁盘 图 标 将 图 表 保 存 起 来 。 
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图 15-1 使 用 Matplotlib 可 制作 的 最 简单 的 图 表 


15.2.1 ”修改 标签 文字 和 线条 粗细 


如 图 15-1 所 示 的 图 形 表 明 数 是 越 来 越 大 的 ， 但 标签 文字 太 小 、 线 条 
~ 难以 看 清楚 。 所 幸 Matplotlib 让 你 能 够 调整 可 视 化 的 各 个 方 


下 面 通 过 一 些 定 制 来 改善 这 个 图 表 的 可 读 性 ， 如 下 所 示 : 


mpl_squares.py 


import matplotlib.pyplot as plt 


squares = [1, 4, 9, 16, 25|] 


fig, ax = plt.subplots() 
@ ax.plot(squares, linewidth=3) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 。 

@ ax.set_title(" 平 方 数 "，fontsize=24) 

@ ax.set _Xxlabel(" 值 "，fontsize=14) 
ax.set_ylabel(" 值 的 平方 "，fontsize=14) 


# 设置 刻度 标记 的 大 小 。 


@ ax.tick params(axis='both', labelsize=14) 


plt. show() 


参数 linewidth ( 见 @) 决定 了 plot() 绘制 的 线条 粗细 。 方 法 
set_title() 〈 见 铺 ) 给 图 表 指 定 标题 。 在 上 述 代码 中 ， 出 现 多 
次 的 参数 fontsize 指定 图 表 中 各 种 文字 的 大 小 。 


方法 set_xlabel() 和 set_ylabel() 让 你 能 够 为 每 条 轴 设 置 标题 

( 见 @)。 方法 tick_params() 设置 刻度 的 样式 〈 见 四 ) ， 其 中 
指定 的 实 参 将 影响 z 轴 和 7 轴 上 的 刻度 (axes='both' ) ， 并 将 刻 
度 标 记 的 字号 设置 为 14 (labelsize=14 ) 。 


最 终 的 图 表 阅 读 起 来 容易 得 多 ， 如 图 15-2 所 示 : 标签 文字 更 大 ， 线 
条 也 更 粗 了 人。 人 通常， 需要 尝试 不 同 的 值 ， 才 能 确定 什么 样 的 设置 生 
成 的 图 表 最 合适 。 
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图 15-2 ”现在 图 表 阅 读 起 来 容易 得 多 
15.2.2 ”校正 图 形 
图 形 更 容易 看 清 后 ， 我 们 发 现 没 有 正确 地 绘制 数据 : 折线 图 的 终点 


指出 4.0 的 平方 为 25! 下 面 来 修复 这 个 问题 。 


问 plot () 提供 一 系列 数 时 ， 它 假设 第 一 个 数据 点 对 应 的 z 坐标 值 
为 0， 但 这 里 第 一 个 点 对 应 的 z 值 为 1。 为 改变 这 种 默认 行为 ， 可 
加 plot() 同时 提供 输入 值 和 输出 值 : 


mpl_squares.py 


import matplotlib.pyplot as plt 


input values = [1, 2, 3, 4,，5] 
squares = [1, 4, 9, 16, 25|] 


fig, ax = plt.subplots() 


ax.plot(input values, squares, linewidth=3) 


# 设置 图 表 标题 并 给 坐标 轴 加 上 标签 。 


--Snip-- 


现在 plot() 将 正确 地 绘制 数据 ， 因 为 同时 提供 了 输入 值 和 输出 
值 ，plot() 无 须 对 输出 值 的 生成 方式 做 出 假设 。 最 终 的 图 形 是 正 
确 的 ， 如 图 15-3 所 示 。 
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图 15-3 根据 数据 正确 地 绘制 了 图 形 


使 用 plot() 时 可 指定 各 种 实 参 ， 还 可 使 用 众多 函数 对 图 形 进 行 定 
制 。 本 革 后 面 处 理 更 有 趣 的 数据 集 时 ， 将 继续 探索 这 些 定制 函数 。 


15.2.3 ”使 用 内 置 样式 


Matplotlib 提 供 了 很 多 已 经 定义 好 的 样式 ， 它 们 使 用 的 背景 色 、 网 
格 线 、 线 条 粗细 、 字 体 、 字 号 等 设置 很 不 错 ， 让 你 无 须 做 太 多 定制 
就 可 生成 引 人 瞩 目的 可 视 化 效果 。 要 获悉 在 你 的 系统 中 可 使 用 哪些 
样式 ， 可 在 终端 会 话 中 执行 如 下 命令 : 


>>> import matplotlib.pyplot as plt 
>>> plt.style.available 
['seaborn-dark', 'seaborn-darkgrid', 'seaborn-ticks', 'fivethirtyeight 


--Snip-- 


要 使 用 这 些 样式 ， 可 在 生成 图 表 的 代码 前 添加 如 下 代码 行 : 
mpl_squares.py 


import matplotlib.pyplot as plt 


input values = [1, 2, 3, 4,5] 
squares = [1, 4, 9, 16, 25] 


plt.style.use('seaborn') 
fig, ax = plt.subplots() 
--Snip-- 


这 些 代 码 生 成 的 图 表 如 图 15-4 所 示 。 可 供 使 用 的 内 置 样式 有 很 多 ， 
请 答 试 使 用 它们 ， 找 出 你 喜欢 的 。 
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图 15-4 内 置 样式 seaborn 
15.2.4 使 用 scatter() 绘制 散 点 图 并 设置 样式 


有 了 时候， 绘制 散 扣 图 并 设置 各 个 数据 点 的 样式 很 有 有 用。 例如， 你 可 
能 想 以 一 种 颜色 显示 较 小 的 值 ， 用 男 一 种 颜色 显示 较 大 的 值 。 绘 制 
大 型 数据 集 时 ， 还 可 对 每 个 点 都 设置 同样 的 样式 ， 再 使 用 不 同 的 样 
式 选 项 重新 绘制 茶 些 点 以 示 突 出 。 


要 绘制 单个 点 ， 可 使 用 方法 scatter() 。 向 它 传递 一 对 z 坐标 和 7 
坐标 ， 它 将 在 指定 位 置 绘制 一 个 点 : 


catter_squares.py 


import matplotlib.pyplot as plt 


plt.style.use('seaborn') 
fig, ax = plt.subplots() 


ax.scatter(2, 4) 


plt. show() 


下 面 来 设置 图 表 的 样式 ， 使 其 更 有 趣 。 我 们 将 添加 标题 ， 给 坐标 轴 


加 上 标签 ， 并 且 确 你 所 有 文本 都 大 到 能 够 看 清 : 


import matplotlib.pyplot as plt 


plt.style.use('seaborn') 
fig, ax = plt.subplots() 
ax.scatter(2, 4,，s=2080) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 。 
ax.set_title(" 平 方 数 "，fontsize=24) 


ax.set xlabel(" 值 "，fontsize=14) 
ax.set_ylabel(" 值 的 平方 "，fontsize=14) 


# 设置 刻度 标记 的 大 小 。 


ax.tick params(axis="'both', which="'major', labelsize=14) 


plt. show() 


在 @ 处 ， 调 用 scatter() 并 使 用 参数 s 设置 绘制 图 形 时 使 用 的 点 的 
尺寸 。 如 果 此 时 运行 Scatter_squares.py， 将 在 图 表 中 央 看 到 一 个 
点 ， 如 图 15-5 所 示 。 
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全 人 中 避 三 
图 15-5 ”绘制 单个 点 


15.2.5 ”使 用 scatter() 绘制 一 系列 点 


要 绘制 一 系列 的 点 ， 可 向 scatter() 传递 两 个 分 别 包含 上 值 和 y 值 
的 列表 ， 如 下 所 示 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


x_values = [1, 2, 3, 4,5] 
y_values = [1, 4, 9, 16, 25] 


plt.style.use('seaborn') 


fig, ax = plt.subplots() 
ax.scatter(x_values, y_values, s=1060) 


# 设置 图 表 标题 并 给 坐标 轴 指 定 标签 。 


--Snip-- 


列表 x_values 包含 要 计算 平方 值 的 数 ， 列 表 y_values 包含 前 述 
数 的 平方 值 。 将 这 些 列表 传递 给 scatter() 时 ，Matplotlib 依 次 从 
每 个 列表 中 读 取 一 个 值 来 绘制 一 个 点 。 要 绘制 的 点 的 坐标 分 别 为 
(1, 1)、(2, 4)、(3, 9)、(4, 16) 和 (5, 25)， 最 终 的 结果 如 图 15-6 所 示 。 


平方 数 


省 拟 了 中 主因 


图 15-6 ”由 多 个 点 组 成 的 散 点 图 


15.2.6 ”自动 计算 数据 

手工 计算 列表 要 包含 的 值 可 能 效率 低下 ， 需 要 绘制 的 点 很 多 时 尤其 
0 0 0 
完成 。 

下 面 是 绘制 1000 个 点 的 代码 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


@ x_values 
y_values 


range(1, 106061) 
[x**2 for x in X values] 


plt.style.use('seaborn') 
fig, ax = plt.subplots() 
@ ax.scatter(x values, y_values, s=10) 


# 设置 图 表 标 题 并 给 坐标 轴 加 上 标签 。 
--Snip-- 


# 设置 每 个 坐标 轴 的 取 值 范围 。 
e ax.axis([6，1166，68，1166666]) 


plt. show() 


首先 创建 了 一 个 包含 值 的 列表 ， 其 中 包含 数 1 一 1000〈 见 @@) 。 
接 下 来 ， 是 一 个 生成 ! 值 的 列表 解析 ， 它 遍历 : 值 (for x in 
x_values ) ， 计 算 其 平方 值 (x**2 ) ， 并 将 结果 存储 到 列 

表 y_values 中 。 然 后 ， 将 输入 列表 和 输出 列表 传递 给 scatter() 
( 见 介 )，。 这 个 数据 集 较 大 ， 因 此 将 点 设置 得 较 小 。 


在 全 处 ， 使 用 方法 axis() 指定 了 每 个 坐标 轴 的 取 值 范围 。 方 法 
axis() 要 求 提 供 4 个 值 : zx 和 7 坐标 轴 的 最 小 值 和 最 大 值 。 这 里 将 > 
坐标 轴 的 取 值 范围 设置 为 0 一 1100， 并 将 y 坐标 轴 的 取 值 范围 设置 为 
0 一 1 100 000。 结 果 如 图 15-7 所 示 。 
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华 所 了 中 加 三 
图 15-7 ”对 Python 来 说 ， 绘 制 1000 个 点 与 绘制 5 个 点 一 样 容 易 
15.2.7 ”上 自 定 义 颜 色 


要 修改 数据 点 的 颜色 ， 可 向 scatter() 传递 参数 c ， 并 将 其 设置 为 
要 使 用 的 颜色 的 名 称 〔 放 在 引号 内 ) ， 如 下 所 示 : 


ax.scatter(x_values, y_values, c='red', s=10) 


还 可 使 用 RGB 颜色 模式 自 定 义 颜 色 。 要 指定 自 定义 颜色 ， 可 传递 参 
数 c ， 并 将 其 设置 为 一 个 元 组 ， 其 中 包含 三 个 0 一 1 的 小 数值 ， 分 别 
表示 红色 、 绿 色 和 蓝 色 的 分 量 。 例 如 ， 下 面 的 代码 行 创建 一 个 由 淡 
绿色 点 组 成 的 散 点 图 : 


ax.scatter(Xx_values，y _ values，c=(6，6.8，686)，s=16) 


值 越 接近 0， 指 定 的 颜色 越 深 ; 值 越 接近 1， 指 定 的 颜色 越 浅 。 
15.2.8 ”使 用 颜色 映射 


颜色 映射 〈colormap) 是 一 系列 颜色 ， 从 起 始 颜色 渐变 到 绎 
色 。 在 可 视 化 中 ， 颜 色 映 射 用 于 突出 数据 的 规律 。 例 如 ， 你 可 
较 浅 的 颜色 来 显示 较 小 的 值 ， 并 舍 用 较 深 的 颜色 来 显示 蒂 大 的 值 。 


模块 pyplot 内 置 了 一 组 颜色 映射 。 要 使 用 这 些 颜 色 映 射 ， 需 要 告 
诉 pyplot 该 如 何 设 置 数据 集中 每 个 点 的 颜色 。 下 面 演示 了 如 何 根 
据 每 个 点 的 y 值 来 设置 其 颜色 : 


scatter_squares.py 


import matplotlib.pyplot as plt 


range(1, 106061) 
[x**2 for x in X _ Values] 


x_values 
y_values 


ax.scatter(x values, y values, c=y_values, cmap=plt.cm.Blues, s=10) 


# 设置 图 表 标题 并 给 坐标 轴 加 上 标签 。 


--Snip-- 


我 们 将 参数 c 设置 成 了 一 个 y 值 列 表 ， 并 使 用 参数 cmap 告诉 
pyplot 使 用 哪个 颜色 映射 。 这 些 代码 将 y 值 较 小 的 点 显示 为 浅 蓝 
色 ， 并 将 y 值 较 大 的 点 显示 为 深蓝 色 ， 结 果 如 图 15-8 所 示 。 
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图 15-8 ”使 用 颜色 映射 Blues 的 图 表 


注意 ”要 了 解 pyplot 中 所 有 的 颜色 映射 ， 请 访问 Matplotlib 网 
站 主页 ， 单 击 Examples， 疝 下 滚动 到 Color， 再 单 击 Colormaps 
reference。 


15.2.9 ”自动 保存 图 表 


要 让 程序 自动 将 图 表 保 存 到 文件 中 ， 可 将 调用 plt.show() 替换 为 
调用 plt.savefig() : 


plt.savefig('squares plot.png', bbox inches='tight') 


第 一 个 实 参 指定 要 以 什么 文件 名 保存 图 表 ， 这 个 文件 将 存储 到 
scatter_squares.py 所 在 的 目录 。 第 二 个 实 参 指定 将 图 表 多 余 的 空白 
Ns A 
实 参 即 可 。 


动手 试 一 试 
练习 15-1: 立方 ” 数 的 三 次 方 称 为 立方 。 请 绘制 一 个 图 形 ， 
显示 前 5 个 整数 的 立方 值 。 再 绘制 一 个 图 形 ， 显 示 前 5000 个 整 
数 的 立方 值 。 
练习 15-2: 彩色 立方 ”给 前 面 绘制 的 立方 图 指定 颜色 映射 。 


15.3 ”随机 漫步 


本 慷 将 使 用 Python 来 生成 随机 漫步 数据 ， 再 使 用 Matplotlib 以 引 人 瞩 
目的 方式 将 这 些 数据 呈现 出 来 。 随 机 漫步 是 这 样 行走 得 到 的 路 

径 : 每 次 行走 部 是 完全 随机 的 、 没 有 明确 的 方向 ， 结 果 是 由 一 系列 
随机 决 倘 决定 的 。 你 可 以 将 随机 漫步 看 作 蚂 蚁 在 尝 头 转向 的 情况 
下 ， 每 次 都 治 随机 的 方 癌 前 行 押 经 过 的 路 径 。 


在 自然界、 物理 学、 生物 学 、 化 学 和 经 痢 领域 ， 随 机 漫步 都 有 其 实 
际 用 途 。 例 如 ， 漂 浮 在 水 滴 上 的 花粉 因 不 断 受 到 水 分 子 的 挤 压 而 在 
水 面 上 移动 。 水 滴 中 的 分 子 运动 是 随机 的 ， 因 此 花粉 在 水 面 上 的 运 
动 路 径 狂 如 随机 漫步 。 我 们 稍 后 编写 的 代码 将 模拟 现实 世界 的 很 多 


情形 。 
15.3.1 创建 RandomWalk 类 


为 模拟 随机 漫步 ， 将 创建 一 个 名 为 RandomWalk 的 类 ， 它 随机 地 选 
择 前 进 方向 。 这 个 类 需要 三 个 属性 : 一 个 是 存储 随机 漫步 次 数 的 变 
量 ， 其 他 两 个 是 列表 ， 分 别 存 储 随机 漫步 经 过 的 每 个 点 的 z 坐标 和 vy 
坐标 。 


RandomWalk 类 只 包含 两 个 方法 : 方法 _ init _() 和 
fill_walk()， 后 者 计算 随机 漫步 经 过 的 所 有 点 。 先 来 看 
看 _init ()， 如 下 所 示 : 


random_walk.py 


@ from random import choice 


class RandomWalk: 


"一 个 生成 随机 漫步 数据 的 类 。""" 


@ def _ init (self，num_points=5666) : 
""" 初 始 化 随机 漫步 的 属性 。""" 


self.num points = num_points 


# 所 有 随机 漫步 都 始 于 (6，0)。 


日 self.x values = [6] 


self.y values = [6] 


为 做 出 随机 决策 ， 将 所 有 可 能 的 选择 都 存储 在 一 个 列表 中 ， 并 在 每 
次 决策 时 都 使 用 模块 random 中 的 choice() 来 决定 使 用 哪 种 选择 

( 见 @) 。 接 下 来 ， 将 随机 漫步 包含 的 默认 点 数 设置 为 5000。 这 个 
数 大 到 足以 生成 有 趣 的 模式 ， 又 小 到 可 确保 能 够 快速 地 模拟 随机 漫 
步 〈 见 外) 。 然 后 ， 在 全 处 创建 两 个 用 于 存储 z 值 和 y 值 的 列表 ， 

并 让 每 次 漫步 都 从 点 (0, 0) 出 发 。 


15.3.2 ”选择 方向 


我 们 将 使 用 方法 fil1_walk() 来 生成 漫步 包含 的 点 并 决定 每 次 漫 
步 的 方向 ， 如 下 所 示 。 请 将 这 个 方法 添加 到 random_walk.py 中 : 


random_walk.py 


def fill walk(self): 
"" "计算 随机 漫步 包含 的 所 有 点 。""" 


# 不 断 漫步 ， 直 到 列表 达到 指定 的 长 度 。 


@ while len(self.x values) < self.num points: 


# 决定 前 进 方向 以 及 沿 这 个 方向 前 进 的 距离 。 
@ x_direction = choice([1, -1]) 


x_distance = choice([60, 1, 2, 3, 4]) 
@ x_step = x_direction * x distance 


y_direction = choice([1, -1]) 
y_distance = choice([6, 1, 2, 3, 4]) 
@ y_step = y_direction * y distance 


# 拒绝 原 地 踏步 。 
9 if x_step == 6 and y_step == 
continue 


# 计算 下 一 个 点 的 x 值 和 y 值 。 
9 x = self.x values[-1] + x_step 
y = self.y values[-1] + y_step 


self.x_ values.append(x) 


self.y _ values.append(y) 


各 处 建立 了 一 个 循环 ， 它 不 断 运 行 ， 直 到 漫步 包含 所 需 的 点 数 。 方 
法 fil1l_walk() 的 主要 部 分 告诉 Python 如 何 模拟 四 种 漫步 决定 : 向 
右 走 还 是 向 左 走 ? 沿 指定 的 方向 走 多 远 ? 向 上 走 还 是 向 下 走 ? 沿 选 
定 的 方向 走 多 远 ? 


使 用 choice([1，-1]) 给 x_direction 选择 一 个 值 ， 结 果 要 么 是 
a 
口 


表示 向 右 走 的 1， 要 么 是 表示 问 左 走 的 -1( 见 介 ) 。 接 下 

来 ，choice([6，1，2，3，4]) 随机 地 选择 一 个 0 一 4 的 整数 ， 
诉 Python 沿 指定 的 方向 走 多 远 (x_distance ) 。 通 过 包含 0， 不 
仅 能 够 同时 沿 两 个 轴 和 移动， 还 能 够 只 沿 一 个 轴 移 动 。 


在 全 和 人 @ 处 ， 将 移动 方向 乘 以 移动 距离 ， 确 定 沿 z 轴 和 7Y 轴 移 动 的 
距离 。 如 果 x_step 为 正 将 向 右 移 动 ， 为 负 将 辐 左 移动 ， 为 零 将 垂 
直 移 动 ， 如 果 y_step 为 正 将 同上 移动 ， 为 负 将 向 下 移动 ， 为 零 将 
水 平移 动 。 如 果 x_step 和 y_step 都 为 零 ， 则 意味 着 原 地 踏步 。 我 
们 拒绝 这 样 的 情况 ， 接 着 执行 下 一 次 循环 〈 见 @@) 。 


为 获取 漫步 中 下 一 个 点 的 z 值 ， 将 x_step 与 x_values 中 的 最 后 一 
个 值 相 加 ( 见 @) ， 对 y 值 也 做 相同 的 处 理 。 获 得 下 一 个 点 的 z 值 
和 y 值 后 ， 将 它们 分 别 附加 到 列表 x_values 和 y_values 的 末尾 。 
15.3.3 ”绘制 随机 漫步 


下 面 的 代码 将 随机 漫步 的 所 有 后 部 绘 制 出 来 : 


rw_visual.py 


import matplotlib.pyplot as plt 


from random walk import RandomWalk 


# 创建 一 个 RandomWalk 实 例 。 
@ rw = RandomWalk() 

rw.fill walk() 

# 将 所 有 的 点 都 绘制 出 来 。 

plt.style.use('classic') 


fig, ax = plt.subplots() 
@ ax.scatter(rw.x values, rw.y_values, s=15) 
plt. show() 


首先 导入 模块 pyplot 和 RandomWalk 类 ， 再 创建 一 个 RandomWalk 
实例 并 将 其 存储 到 rw 中 〈 见 @) ， 并 且 调 用 fil1_walk() 。 在 人 @ 
处 ， 将 随机 漫步 包含 的 z 值 和 7Y 值 传递 给 scatter() ， 并 选择 合适 
的 点 尺寸 。 图 15-9 显 示 了 包含 5000 个 点 的 随机 漫步 图 。( 本 节 的 示 
意图 未 包含 Matplotlib 查 看 器 的 界面 ， 但 你 运行 rw_visual.py 时 会 看 
到 。) 


图 15-9 ”包含 5000 个 点 的 随机 漫步 
15.3.4 ”模拟 多 次 随机 漫步 
每 次 随机 漫步 都 不 同 ， 因 此 探索 可 能 生成 的 各 种 模式 很 有 趣 。 要 在 


不 多 次 运行 程序 的 情况 下 使 用 前 面 的 代码 模拟 多 次 随机 漫步 ， 一 种 
办 法 是 将 这 些 代 码 放 在 一 个 while 循环 中 ， 如 下 所 示 : 


rw_visual.py 


import matplotlib.pyplot as plt 


from random _ walk import RandomWalk 


# 只 要 程序 处 于 活动 状态 ， 就 不 断 地 模拟 随机 漫步 。 
while True: 

# 创建 一 个 RandomWalk 实 例 。 

rw = RandomWalk() 

rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 。 
plt.style.use('classic') 

fig, ax = plt.subplots() 

ax.scatter(rw.x values, rw.y_values, s=15) 
plt. show() 


keep_running = input("Make another walk? (y/n): ") 
if keep _running == "Nn": 
break 


这 些 代码 模拟 一 次 随机 漫步 ， 在 Matplotlib 碍 看 器 中 显示 结果 ， 再 
在 不 关闭 奏 看 右 的 情况 下 和 暂停。 如 果 关 闭 碍 看 器 ， 程 序 将 询问 是 人 否 
要 再 模拟 一 次 随机 漫步 。 如 果 输 入 y ， 可 模拟 在 起 点 附近 进行 的 随 
机 漫步 、 大 多 沿 特定 方 癌 侦 离 起 点 的 随机 漫步 、 漫 步 点 分 布 不 均匀 
的 随机 漫步 ， 等 等 。 要 结束 程序 ， 请 输入 n 。 


15.3.5 ”设置 随机 漫步 图 的 样式 


本 节 将 定制 图 表 ， 以 突出 每 次 漫步 的 重要 特征 ， 并 让 分 散 注意 力 的 
元 素 不 那么 显眼 。 为 此 ， 我 们 确定 要 突出 的 元 素 ， 如 漫步 的 起 点 、 
终点 和 经 过 的 路 径 。 接 下 来 确定 要 使 其 不 那么 显眼 的 元 际 ， 如 刻度 
标记 和 标签 。 最 终 的 结果 是 简单 的 可 视 化 表示 ， 清 楚 地 指出 了 每 次 
漫步 经 过 的 路 径 。 


a. 给 点 着 色 


我 们 将 使 用 颜色 映射 来 指出 漫步 中 各 点 的 先后 顺序 ， 并 删除 每 
个 点 的 黑色 轮廓 ， 让 其 颜色 更 为 明显 。 为 根据 漫步 中 各 点 的 先 
后 顺序 来 着 色 ， 传 递 参数 c ， 并 将 其 设置 为 一 个 列表 ， 其 中 包 
含 各 点 的 先后 顺序 。 这 些 点 古 按 顺 序 绘制 的 ， 因 此 给 参数 c 指 


定 的 列表 只 需 包 含 数 0 一 4999， 如 下 所 示 : 
rw_visual.py 


--Snip-- 

while True : 
# 创建 一 个 RandomWalk 实 例 。 
rw = RandomWalk() 
rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 。 

plt.style.use('classic') 

fig, ax = plt.subplots() 

point numbers = range(rw.num points) 

ax.scatter(rw.x values, rw.y_values, c=point numbers, cmap= 
edgecolors='none', s=15) 

plt. show() 


keep_running = input("Make another walk? (y/n): ") 
--Snip-- 


在 @@ 处 ， 使 用 range() 生成 了 一 个 数字 列表 ， 其 中 包含 的 数 与 
漫步 包含 的 点 数量 相同 。 接 下 来 ， 将 这 个 列表 存储 

在 point_numbers 中 ， 以 便 后 面 使 用 它 来 设置 每 个 漫步 点 的 
颜色 。 将 参数 c 设置 为 point_numbers ， 指 定 使 用 颜色 了 映 
射 Blues ， 并 传递 实 参 edgecolors='none ' 以 删除 每 个 点 周 
最 终 的 随机 漫步 图 从 浅 蓝 色 渐 变 为 深蓝 色 ， 如 图 
15-10 所 不 。 
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图 15-10 ”使 用 颜色 映射 Blues 着 色 的 随机 漫步 图 


. 重新 绘制 起 点 和 终点 


除了 给 随机 漫步 的 各 个 点 着 色 ， 以 指出 其 先后 顺序 外 ， 如 果 还 
能 呈现 随机 漫步 的 起 点 和 终点 束 好 了 。 为 此 ， 可 在 绘制 随机 漫 
步 图 后 重新 绘制 起 点 和 终点 。 这 里 让 起 点 和 终点 更 大 并 显示 为 
不 同 的 颜色 ， 以 示 突 出 ， 如 下 所 示 : 


rw_visual.py 


--Snip-- 
while True : 
--Snip-- 
ax.scatter(rw.x_values, rw.y_values, c=point numbers, cmap=pl 
edgecolors='none', s=15) 


# 突出 起 点 和 终点 。 


ax.scatter(0, 606, c='green', edgecolors='none', s=1060) 
ax.scatter(rw.x values[-1], rw.y_values[-1], c='red', edgecol 
s=166) 


plt. show() 
--Snip-- 


为 突出 起 点 ， 使 用 绿色 绘制 点 (0, 0)， 并 使 其 比 其 他 点 大 
(Cs=166 ) 。 为 突出 终点 ， 在 漫步 包含 的 最 后 一 个 z 值 和 y 值 
处 绘制 一 个 点 ， 将 其 颜色 设置 为 红色 ， 并 将 尺寸 设置 为 100。 
务必 将 这 些 代 码 放 在 调用 plt.show() 的 代码 前 面 ， 确 保 在 其 
他 点 之 上 绘制 起 点 和 终点 。 


如 果 现 在 运行 这 些 代码 ， 将 能 准确 地 知道 每 次 随机 漫步 的 起 点 
和 终点 。〔 如 果 起 点 和 终点 不 明显 ， 请 调整 颜色 和 大 小 ， 直 到 
明显 为 止 。) 


.隐藏 坐标 轴 


下 面 来 隐藏 这 个 图 表 的 坐标 轴 ， 以 免 分 散 观察 者 对 随机 漫步 路 
径 的 注意 力 。 要 隐藏 坐标 轴 ， 可 使 用 如 下 代码 : 


rw_visual.py 


--Snip-- 
while True : 
--Snip-- 
ax.scatter(rw.x values[-1], rw.y_values[-1], c='red', edgec 
s=166) 


# 隐藏 坐标 轴 。 


ax.get xaxis().set visible(False) 
ax.get yaxis().set visible(False) 


plt. show() 
--Snip-- 


为 修改 坐标 轴 ， 使 用 方法 ax.get_xaxis() 和 
ax.get_yaxis() 〈( 见 @) 将 每 条 坐标 轴 的 可 见 性 都 设置 

为 False 。 随 着 对 数据 可 视 化 的 不 断 学 习 和 实践 ， 你 会 经 常 看 
到 这 种 串 接 方法 的 方式 。 


如 果 现 在 运行 rw_visual.py， 你 将 看 到 一 系列 图 形 ， 但 看 不 到 坐 
标 轴 。 


d. 增加 点 数 


下 面 来 增加 点 数 ， 以 提供 更 多 数据 。 为 此 ， 在 创建 
RandomWalk 实例 时 增 大 num_points 的 值 ， 并 在 绘图 时 调整 
每 个 点 的 大 小 ， 如 下 所 示 : 


rw_visual.py 


--Snip-- 

while True : 
# 创建 一 个 RandomWalk 实 例 。 
rw = RandomWalk(56 660) 
rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 。 


plt.style.use('classic') 

fig, ax = plt.subplots() 

point numbers = range(rw.num points) 

ax.scatter(rw.x values, rw.y_values, c=point numbers, cmap=pl 
edgecolor='none', s=1) 

--Snip-- 


这 个 示例 模拟 了 一 次 包含 50 000 个 点 的 随机 漫步 《以 模拟 现实 
情况 )，， 并 将 每 个 点 的 大 小 都 设置 为 1。 最 终 的 随机 漫步 图 更 
稳 蕊 ， 狐 如 云 末 ， 如 图 15-11 所 示 。 如 你 所 见 ， 我 们 使 用 简单 
的 散 点 图 制作 出 了 一 件 艺 术 品 ! 
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图 15-11 包含 50 000 个 点 的 随机 漫步 


请 尝试 修改 上 述 代 码 ， 看 看 将 漫步 包含 的 点 数 增加 到 多 少 后 ， 
程序 的 运行 速度 变 得 极其 缓慢 或 绘制 出 的 图 形变 得 很 难看 。 


. 调整 矿 寸 以 适合 屏幕 


图 表 适 合 屏 人 莫大 小 时 ， 更 能 有 效 地 将 数据 中 的 规律 呈现 出 来 。 
为 让 绘图 窗口 更 适合 屏幕 大 小 ， 可 以 像 下 面 这 样 调整 
Matplotlib 输 出 的 尺寸 : 


rw_visual.py 


--Snip-- 

while True : 
# 创建 一 个 RandomWalk 实 例 。 
rw = RandomwWalk(56 666) 
rw.fill walk() 


# 将 所 有 的 点 都 绘制 出 来 。 
plt.style.use('classic') 

fig, ax = plt.subplots(figsize=(15, 9)) 
--Snip-- 


创建 图 表 时 ， 可 传递 参数 figsize 以 指定 生成 的 图 形 的 尺寸 。 
需要 给 参数 figsize 指定 一 个 元 组 ， 同 Matplotlib 指 出 绘图 窗 
口 的 尺寸 ， 单 位 为 英寸 1 。 


Matplotlib 假 定 屏 幕 分 辨 率 为 100 像 素 / 英 寸 。 如 果 上 述 代 码 指 定 
的 图 表 尺 寸 不 合适 ， 可 根据 需要 调整 数字 。 如 果 知 道 当 前 系统 
的 分 辩 率 ， 可 通过 参数 dpi 向 plt.subplots() 传递 该 分 辨 
率 ， 以 有 效 利 用 可 用 的 屏幕 空间 ， 如 下 所 示 : 


fig, ax = plt.subplots(figsize=(16，6)，dpi=128) 


11 英 寸 =2.54 厘米 。 一 编者 注 
动手 试 一 斌 


练习 15-3: 分 子 运动 ”修改 rw_visual.py， 将 其 中 的 
ax.scatter() 蔡 换 为 ax.plot() 。 为 模拟 花粉 在 水 滴 表 面 的 
运动 路 笃 ， 同 plt .plot() 传递 rw.x_values 和 rw.y_values 
， 并 指定 实 参 1inewidth 。 请 使 用 5000 个 点 而 不 是 50 000 个 
i 


练习 15-4: 改进 的 随机 漫步 ”在 类 RandomWalk 中 ，x_step 

和 y_step 是 根据 相同 的 条 件 生成 的 :从 列表 [1，-1] 中 随机 

选择 方向 ， 并 从 列表 [6，1，2，3，4] 中 随机 选择 距离 。 请 

修改 这 些 列表 中 的 值 ， 看 看 对 随机 漫步 路 径 有 何 影 响 。 答 试 使 

《如 0 一 8) ， 或 者 将 -1 从 z 或 y 方 向 列 
删除 。 


练习 15-5: 重 构 方法 fil1_ walk() 很 长 。 请 新 建 一 个 名 
为 get_step() 的 方法 ， 用 于 确定 每 次 漫步 的 距离 和 方向 ， 并 
计算 每 一 步 。 然 后 ， 在 fi11_walk() 中 调用 get_step() 两 
次 : 


x_step = self.get step() 
y_step = self.get_ step() 


通过 这 样 的 重 构 ， 可 缩小 方法 fil1_walk() ， 让 它 阅读 和 理 
解 起 来 更 容易 。 


15.4 ”使 用 Ploty 模 拟 掷 般 子 


本 节 将 使 用 Python 包 Plotly 来 生成 交互 式 图 表 。 需 要 创建 在 浏览 需 
中 显示 的 图 表 时 ，Ploty 很 有 用 ， 因 为 它 生 成 的 图 表 将 目 动 给 放 以 
适合 观看 者 的 屏幕 。Plotly 生 成 的 图 表 还 是 交互 式 的 : 用 户 将 鼠标 
指向 特定 元 素 时 ， 将 突出 显示 有 关 该 元 系 的 信息 。 


在 这 个 项 目 中 ， 我 们 将 对 掷 般 子 的 结 条 进行 分 析 。 抛 扼 一 个 6 面 的 
常规 角 子 时 ， 可 能 出 现 的 结果 为 1~~6 点 ， 且 出 现 每 种 结果 的 可 能 性 
相同 。 然 而 ， 如 果 同 时 撕 两 个 散 子 ， 杂 些 后 数 出 现 的 可 能 性 将 比 其 
他 点 数 大 。 为 确定 哪些 点 数 出 现 的 可 能 性 最 大 ， 将 生成 一 个 表示 撕 
角子 结果 的 数据 集 ， 并 根据 结果 绘制 一 个 图 形 。 


在 数学 领域 ， 掷 仍 子 币 家 用 来 解释 各 种 数据 分 析 类 型 ， 而 它 在 赌场 
和 其 他 博弈 场景 中 也 有 实际 应 用 ， 在 游戏 《大 富翁 》 以 及 众多 角色 
扮演 游戏 中 亦 如 此 。 


15.4.1 ”安装 Plotly 


要 安装 Plody， 可 像 本 章 前 面 安装 Matplotlib 那 样 使 用 pip : 


$ python -m pip install --user plotly 


在 前 面 安装 Matplotlib 时 ， 如 果 使 用 了 python3 之 类 的 命令 ， 这 里 
也 要 使 用 同样 的 命令 。 

要 了 人 解 使 用 Plotly 可 创建 什么 样 的 图 表 ， 请 在 其 官方 网 站 查看 图 表 
$30 0 2 
条 。 

15.4.2 ”创建 Die 类 


为 模拟 掷 一 个 人 般 子 的 情况 ， 我 们 创建 下 面 的 类 : 


die.py 
from random import randint 


class Die: 
[0 "表示 一 个 骨 子 的 类 。 mn nn 


def _ init (self, num sides=6): 


”…" 般 子 默 认为 6 面 。"”" 


self.num sides = num sides 


def roll(self): 
""" "返回 一 个 位 于 1 和 骨 子 面 数 之 间 的 随机 值 。""" 


return randint(1, self.num sides) 


方法 _init () 接受 一 个 可 选 参 数 。 创 建 这 个 类 的 实例 时 ， 如 果 
没有 指定 任何 实 参 ， 面 数 默 认为 6; 如 果 指 定 了 实 参 ， 这 个 值 将 用 
于 设置 骨 子 的 面 数 〈 见 @)，。 角 子 是 根据 面 数 命名 的 ，6 面 的 骨 子 
名 为 D6，8 面 的 仍 子 名 为 D8， 依 此 类 推 。 


方法 rol1() 使 用 函数 randint() 来 返回 一 个 1 和 面 数 之 间 的 随机 
数 〈 见 贸 ) 。 这 个 函数 可 能 返回 起 始 值 1、 终 止 值 num_sides 或 这 
两 个 值 之 间 的 任何 整数 。 

15.4.3 ” 掷 明 子 


使 用 这 个 类 来 创建 图 表 前 ， 移 来 扼 D6， 将 结果 打印 出 来 ， 并 确认 
结果 是 合理 的 : 


die_visual.py 


from die import Die 


# 创建 一 个 D6。 
@ die = Die() 


# 掷 几 次 仍 子 并 将 结果 存储 在 一 个 列表 中 。 
results = [] 
@ for roll num in range(166) : 
result = die.roll() 


results.append(result) 


print(results) 


在 @@ 处 ， 创 建 一 个 Die 实例 ， 其 面 数 为 默认 值 6。 在 外 处 ， 掷 般 子 
2 S00 hw 下面 是 二 侍 示 
列 结果 集 : 


通过 快速 浏览 这 些 结果 可 知 ，Die 类 似乎 没有 问题 。 我 们 见 到 了 值 
1 和 6， 表 明 返 回 了 最 大 和 最 小 的 可 能 值 ， 没 有 见 到 0 或 7， 表 明 结果 
都 在 正确 的 范围 内 ， 还 看 到 了 1 一 6 的 所 有 数字 ， 表 明 所 有 可 能 的 结 
打者 出 现 了 。 下 面 来 确定 各 个 点 数 都 出 现 了 多 少 次 。 


15.4.4 ”分 析 结 


为 分 析 撕 一 个 D6 的 结果 ， 计 算 每 个 点 数 出 现 的 次 数 : 


die_visual.py 


--Snip-- 
# 撕 几 次 般 子 并 将 结果 存储 在 一 个 列表 中 。 
results = [] 


@ for roll num in Fange(1666) : 
result = die.roll() 
results.append(result) 


# 分 析 结 果 。 

frequencies = [] 
@ for value in range(1, die.num sides+1): 
3 frequency = results.count(value) 
@ frequencies.append(frequency) 


print(frequencies) 


由 于 将 使 用 Plotly 来 分 析 ， 而 不 是 将 结果 打印 出 来 ， 因 此 可 将 模拟 
据 仍 子 的 次 数 增加 到 1000《〈 见 辆 ) 。 为 分 析 结 果 ， 我 们 创建 空 列 

表 frequencies ， 用 于 存储 每 种 点 数 出 现 的 次 数 。 在 四 处 ， 通 历 

可 能 的 点 数 〈 这 里 为 1 一 6) ， 计 算 每 种 点 数 在 results 中 出 现 了 多 
少 次 ( 见 @) ， 并 将 这 个 值 附 加 到 列表 frequencies 的 末尾 〈 见 

四 ) 。 接 下 来 ， 在 可 视 化 之 前 将 这 个 列表 打印 出 来 : 


[155，167，168，178，159，1811] 


结果 看 起 来 是 合理 的 : 有 6 个 值 ， 对 应 掷 D6 时 可 能 出 现 的 每 个 点 
数 ， 力 外 ， 没 有 任何 点数 出 现 的 频率 比 其 他 点 数 蜗 很多。 下 面 来 可 
视 化 这 些 结果 。 


15.4.5 ”绘制 直方 图 
有 了 频率 列表 ， 束 可 以 绘制 一 个 表示 结果 的 直方 图 了 。 直 方 图 是 


二 种 条 形 图 ， 指 出 了 各 种 结果 出 现 的 频率 。 创 建 这 种 直方 图 的 代码 
I 下 : 


die_visual.py 


from plotly.graph _ objs import Bar, Layout 
from plotly import offline 


from die import Die 
--Snip-- 


# 分 析 结 采 。 

frequencies = [] 

for value in range(1, die.num sides+1): 
frequency = results.count(value) 
frequencies.append(frequency) 


# 对 结果 进行 可 视 化 。 
@ x values = list(range(1, die.num sides+1)) 


@ data = [Bar(x=x_values, y=frequencies)] 


e@ x axis config = {'title': ' 结 果 '} 
y_axis_config = {'title': ' 结 果 的 频率 '} 
@ my_layout = Layout(title= ' 搓 一 个 D6 16866 次 的 结果 '， 
xaxis=x_axis config, yaxis=y axis config) 
@ offline.plot({'data': data, 'layout': my_layout}, filename="'d6.html' 


为 创建 直方 图 ， 需 要 为 每 个 可 能 出 现 的 点 数 生成 一 个 条 形 。 我 们 将 
可 能 出 现 的 点 数 〈1 到 盟 子 的 面 数 ) 存储 在 一 个 名 为 x_values 的 列 
表 中 〈 见 @) 。Plotly 不 能 直接 接受 函数 range() 的 结果 ， 因 此 需 
要 使 用 函数 1ist() 将 其 转换 为 列表 。Plotly 类 Bar() 表示 用 于 绘制 
条 形 图 的 数据 集 ( 见 @) ， 需 要 一 个 存储 z 值 的 列表 和 一 个 存储 7 


二 列表 。 这 个 类 必须 放 在 方 插 号 内 ， 因 为 数据 集 可 能 包含 多 个 元 


每 个 坐标 轴 都 能 以 不 同 的 方式 进行 配置 ， 而 每 个 配置 选项 都 是 一 个 
字典 元 素 。 这 里 只 设置 了 坐标 轴 标 签 ( 见 人 @) 。 类 Layout() 返回 
一 个 指定 图 表 布 局 和 配置 的 对 象 〈 见 四) 。 这 里 设置 了 图 表 名 称 ， 

并 传 入 了 z 轴 和 Y 轴 的 配置 字典 。 


为 生成 图 表 ， 我 们 调用 了 函数 offline.plot()〈( 见 @) 。 这 个 阴 
数 需 要 一 个 包含 数据 和 布局 对 象 的 字典 ， 还 接受 一 个 文件 名 ， 指 定 
要 将 图 表 保 存 到 哪里 。 这 里 将 输出 存储 到 文件 d6.html。 


运行 程序 die_visual.py 时 ， 可 能 打开 浏览 器 并 显示 文件 d6.html。 如 
果 没 有 自动 显示 d6.html， 可 在 任意 Web 浏 览 嚣 中 新 建 一 个 标签 页 ， 
再 在 其 中 打开 文件 d6.html〈 它 位 于 die_visual.py 所 在 的 文件 夹 

中 ) 。 你 将 看 到 一 个 类 似 于 图 15-12 所 示 的 图 表 。 (为 方便 印刷 ， 
我 稍微 修改 了 这 个 图 表 。 在 默认 情况 下 ，Ploty 所 生成 图 表 的 文本 
比 图 15-12 所 示 的 要 小 。) 


掷 一 个 D6 1000 次 的 结果 


结果 


图 15-12 ”使 用 Plotly 创 建 的 简单 条 形 图 


注意 ，Plotly 让 这 个 图 表 具 有 交互 性 :如果 将 鼠标 指向 其 中 的 任意 
条 形 ， 就 能 看 到 与 之 相关 联 的 数据 。 在 同一 个 图 表 中 绘制 多 个 数据 
集 时 ， 这 项 功能 特别 有 用 。 男 外， 注意 到 右上 角 有 一 些 图 标 ， 让 你 
能 够 平移 和 缩放 图 表 以 及 将 其 保存 为 图 像 。 


15.4.6 ”同时 掷 两 个 明子 


同时 撕 两 个 角 子 时 ， 得 到 的 点 数 更 多 ， 结 果 分 布 情况 也 不 同 。 下 面 
来 修改 前 面 的 代码 ， 创 建 两 个 D6 以 模拟 同时 掷 两 个 般 子 的 情况 。 
每 次 措 两 个 角子 时 ， 都 将 两 个 角 子 的 点 数 相 加 ， 并 将 结果 存储 

在 results 中 。 请 复制 die_visual.py 并 将 其 保存 为 dice_visual.py， 
再 做 如 下 修改 : 


dice_visual.py 


from plotly.graph_ objs import Bar, Layout 
from plotly import offline 


from die import Die 


# 创建 两 个 D6。 
die 1 = Die() 
die 2 = Die() 


# 掷 几 次 仍 子 并 将 结果 存储 在 一 个 列表 中 。 
results = [] 
for roll _ num in range(1666) : 
© result = die 1.roll() + die 2.roll() 
results.append(result) 


# 分 析 结 果 。 
frequencies = [] 
@ max_result = die 1.num sides + die 2.num sides 
@ for value in range(2, max_result+1): 
frequency = results.count(value) 
frequencies.append(frequency) 


# 可 视 化 结果 。 
x_values = list(range(2, max_result+1)) 
data = [Bar(x=x_values, y=frequencies)] 


@ x_axis_config = {'title': “结果 '， 'dtick': 1} 
y_axis_config = {'title': ' 结 果 的 频率 '} 
my_layout = Layout(title=' 搓 两 个 D6 186868 次 的 结果 '， 
xaxis=x_axis config, yaxis=y axis config) 
offline.plot({'data': data, 'layout': my_layout}, filename='d6 d6.ht 


创建 两 个 Die 实例 后 ， 折 山 子 多 次 ， 并 计算 每 次 的 总 点 数 〈( 见 
@) .可 能 出 现 的 最 大 点 数 为 两 个 人 般 子 的 最 大 可 能 点 数 之 和 

(12) ， 这 个 值 存储 在 max_result 中 ( 见 @) 。 可 能 出 现 的 最 小 
总 点 数 为 两 个 般 子 的 最 小 可 能 点 数 之 和 (2) 。 分 析 结 果 时 ， 计 算 2 
到 max_result 的 各 种 点 数 出 现 的 次 数 ( 见 @) 。 我们 原本 可 以 
使 用 range(2，13) ， 但 这 只 适用 于 两 个 D6。 模 拟 现实 世界 的 情形 


时 ， 最 好 编写 可 轻松 模拟 各 种 情形 的 代码 。 前 面 的 代码 让 我 们 能 够 
模拟 掷 任意 两 个 般 子 的 情形 ， 不 管 这 些 般 子 有 多 少 面 。) 


创建 图 表 时 ， 在 字典 x_axis_config 中 使 用 了 dtick 键 〈 见 

四 ) . 这 项 设置 指定 了 z 轴 显 示 的 刻度 间距 。 这 里 绘制 的 直方 图 包 
售 的 条 形 更 多 ，Plotly 默 认 只 显示 茶 些 刻度 值 ， 而 设置 "dtick': 1 
另外 ， 我 们 还 修改 了 图 表 名 称 及 输出 文 


运行 这 些 代码 后 ， 你 将 看 到 如 图 15-13 所 示 的 图 表 。 


毛 两 个 D6 1000 次 的 结 
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图 15-13 ”模拟 同时 掷 两 个 6 面 般 子 1000 次 的 结 


这 个 图 表 显 示 了 掷 两 个 D6 时 得 到 的 大 致 结果 。 如 你 所 见 ， 总 点 数 
为 2 或 12 的 可 能 性 最 小 ， 而 总 点 数 为 7 的 可 能 性 最 大 。 这 是 因为 在 下 
面 6 种 情况 下 得 到 的 总 点 数 都 为 7 1 和 6、2 和 5、3 和 4、4 和 3、5 和 2 
以 及 6 和 1。 


15.4.7 同时 括 两 个 面 数 不 同 的 般 子 


下 面 来 创建 一 个 6 面 角 子 和 一 个 10 面 骨 子 ， 看 看 同时 搂 这 两 个 骨 子 
50 000 次 的 结果 如 何 : 


人 


dice_visual.py 


from plotly.graph_ objs import Bar, Layout 
from plotly import offline 


from die import Die 


# 创建 一 个 D6 和 一 个 D16。 
die 1 = Die() 
@ die 2 = Die(16) 


# 撕 几 次 角 子 并 将 结果 存储 在 一 个 列表 中 。 
results = [] 
for roll num in range(58 666) : 


result = die 1.roll() + die 2.roll() 
results.append(result) 


# 分 析 结 果 。 
--Snip-- 


# 可 视 化 结果 。 
x_values = list(range(2, max_result+1)) 
data = [Bar(x=x_values, y=frequencies)] 


x_axis_config = {'title': ' 结 果 '，'dtick': 1} 
y_axis_config = {'title': “结果 的 频率 '} 
@ my_layout = Layout(title= ' 据 一 个 D6 和 一 个 D16 56666 次 的 结果 '"， 
xaxis=x_axis config, yaxis=y axis config) 
offline.plot({'data': data, 'layout': my_layout}, filename='d6 d18.h 


为 创建 D10， 我 们 在 创建 第 二 个 Die 实例 时 传递 了 实 参 16 ( 见 
@) ; 修改 了 第 一 个 循环 ， 以 模拟 掷 盟 子 50 000 而 不 是 1000 次 ; 还 
修改 了 图 表 名 称 和 输出 文件 名 ( 见 @) 。 


图 15-14 显 示 了 最 终 的 图 表 。 可 能 性 最 大 的 点 数 不 止 一 个 ， 而 是 有 5 
个 。 这 是 因为 导致 出 现 最 小 点 数 和 最 大 点 数 的 组 合 都 只 有 一 种 (1 
和 1 以 及 6 和 10) ， 但 面 数 较 小 的 骨 子 限制 了 得 到 中 间 点 数 的 组 合 
数 : 得 到 总 点 数 7、8、9、10 和 11 的 组 合 数 都 是 6 种 。 因 此 ， 这 些 总 
点 数 是 最 常见 的 结果 ， 它 们 出 现 的 可 能 性 相同 。 
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图 15-14 ”同时 掷 6 面 般 子 和 10 面 人 般 子 50 000 次 的 结果 


通过 使 用 Plotly 模 拟 撕 骨 子 的 结果 ， 我 们 能 够 非常 目 由 地 探索 这 种 
现象 。 只 需 几 分 钟 ， 束 可 模拟 撕 各 种 散 子 很 多 次 。 


动手 试 一 斌 


练习 15-6: 两 个 D8 ”编写 一 个 程序 ， 模 拟 同时 掷 两 个 8 面 骨 子 
1000 次 的 结果 。 先 想象 一 下 结果 会 是 什么 样 的 ， 再 运行 这 个 程 
序 ， 看 看 你 的 直觉 准 不 准 。 逐 渐 增 加 撕 骨 子 的 次 数 ， 直 到 系统 
不 堪 重 负 为 止 。 


练习 15-7: 同时 掷 三 个 股子 ”同时 掷 三 个 D6 时 ， 可 能 得 到 的 
站 
D6 的 结 


练习 15-8: 将 点数 相 乘 ” 同 时 撕 两 个 般 子 时 ， 通 常 将 其 点数 
相 加 。 请 通过 可 视 化 展示 将 两 个 散 子 的 点 数 相 乘 的 结果 。 


练习 15-9: 改 用 列表 解析 ”为 清晰 起 见 ， 本 市 模拟 撕 角 子 的 
结果 时 ， 使 用 的 是 较 长 的 for 循环 。 如 果 你 熟悉 列表 解析 ， 答 
试 将 这 些 程序 中 的 一 个 或 两 个 for 循环 改 为 列表 解析 。 


练习 15-10 使 用 两 个 库 : 尝试 使 用 Matplotlib 通 过 可 视 化 来 模拟 
撕 角 子 的 情况 ， 并 尝试 使 用 Plotly 通 过 可 视 化 来 模拟 随机 漫步 
的 情况 。 要 完成 这 个 练习 ， 需 要 查看 这 些 库 的 文档 。 


15.5 小结 


在 本 章 中 ， 你 学 习 了 : 如 何 生 成 数据 集 以 及 如 何 对 其 进行 可 视 化 ; 
如 何 使 用 Matplotlib 创 建 简单 的 图 表 ， 以 及 如 何 使 用 散 点 图 来 探索 
随机 漫步 过 程 ; 如 何 使 用 Plotly 来 创建 直方 图 ， 以 及 如 何 使 用 直方 
图 来 探索 同时 撕 两 个 面 数 不 同 的 般 子 的 结 


使 用 代码 生成 数据 集 是 一 种 有 趣 而 强大 的 方式 ， 可 用 于 模拟 和 探索 
现实 世界 的 各 种 情形 。 完 成 后 面 的 数据 可 视 化 项 目 时 ， 请 注意 可 使 
用 代码 模拟 哪些 情形 。 请 研究 新 闻 媒 体 中 的 可 视 化 ， 看 看 其 中 是 否 
有 图 表 是 以 你 在 这 些 项 目 中 学 到 的 类 似 方式 生成 的 。 


在 第 16 章 中 ， 我 们 将 从 网 上 下 载 数 据 ， 并 继续 使 用 Matplotlib 和 
Plotly 来 探索 这 些 数据 。 


第 16 半 下 载 数据 


~ 本 童 将 从 网 上 下 载 数 据 ， 并 对 其 进行 可 视 化 。 网 
上 的 数据 多 得 令 人 难以 置信 ， 大 多 未 经 仔细 检查 。 如 果 能 够 对 
这 些 数 据 进行 分 机 ， 就 能 发 现 询 人 没有 发 现 的 规律 和 关联 。 


本 章 将 访问 并 可 视 化 的 数据 以 两 种 常见 格式 存储 : CSV 和 
JSON。 我 们 将 使 用 Python 模块 csv 来 处 理 以 CSV 格 式 存储 的 天 
气 数据 ， 找 出 两 个 地 区 在 一 段 时 间 内 的 最 高 温度 和 最 低温 度 。 
然后 ， 使 用 Matplotlib 根 据 下 载 的 数据 创建 一 个 图 表 ， 展 示 两 
个 不 同 地 区 的 温度 变化 : 阿拉 斯 加 州 锡 特 卡 和 加 利 福 尼 亚 州 死 
亡 谷 。 然 后 ， 使 用 模块 json 访问 以 JSON 格 式 存储 的 地 震 数 
据 ， 并 使 用 Plotly 绘 制 一 幅 散 点 图 ， 展 示 这 些 地 震 的 位 置 和 震 
级 。 


阅读 本 章 后 ， 你 将 能 够 处 理 各 种 类 型 和 格式 的 数据 集 ， 并 对 如 
何 创建 复杂 的 图 表 有 深入 的 认识 。 要 处 理 各 种 真实 的 数据 集 ， 
必须 能 够 访问 并 可 视 化 各 种 类 型 和 格式 的 在 线 数据 。 


16.1 CSV 文 件 格式 


要 在 文本 文件 中 存储 数据 ， 一 个 简单 方式 是 将 数据 作为 一 系列 以 去 
号 分 隔 的 值 (comma-separated values) 写 入 文件 。 这 样 的 文件 称 
为 CSV 文件 。 例如， 下 面 是 一 行 CSV 格 式 的 天 气 数 据 : 


"USWe6825333","SITKA AIRPORT, AK US","20618-061-061","0.45",,"48","38" 


这 是 阿拉 斯 加 州 锡 特 卡 2018 年 1 月 1 日 的 天 气 数据 ， 其 中 包含 当天 的 
最 高 温度 和 最 低温 度 ， 还 有 众多 其 他 的 数据 。CSV 文 件 对 人 来 说 阅 
读 起 来 比较 麻烦 ， 但 程序 可 轻松 提取 并 处理 其 中 的 值 ， 有 助 于 加 快 
数据 分 析 过 程 。 


我 们 将 首先 处 理 少 量 CSV 格 式 的 锡 特 卡 天 气 数据 ， 这 些 数据 可 在 本 

书 的 配套 资源 (ituring.cn/ book/2784) 中 找到 。 请 将 文件 

sitka_weather_07-2018_simple.csv 复 制 到 存储 本 章程 序 的 文件 夹 中 。 
(下 载 本 书 的 配套 资源 后 ， 束 有 了 这 个 项 目 所 需 的 所 有 文件 。) 


注意 ”该 项 目 使 用 的 天 气 数据 来 自 美国 国家 海洋 与 大 气管 理 
局 (National Oceanic and Atmospheric Administration, 
NOAA) 。 


16.1.1 分 析 CSV 文 件 头 

csv 模块 包 售 在 Python 标准 库 中 ， 可 用 于 分 析 CSV 文 件 中 的 数据 
行 ， 让 我 们 能 够 快速 提取 感 兴趣 的 值 。 先 来 查看 这 个 文件 的 第 一 
行 ， 其 中 的 一 系列 文件 头 指 出 了 后 续 各 行 包 含 的 是 什么 样 的 信息 : 


sitka_highs.py 


import csyv 


filename = 'data/sitka weather 67-20618 simple.csv" 
@ with open(filename) as f: 
@ reader = csv.reader(f) 
3 header row = next(reader) 


print(header_row) 


导入 模块 csv 后 ， 将 要 使 用 的 文件 的 名 称 赋 给 filename 。 接 下 
来 ， 打 开 这 个 文件 ， 并 将 返回 的 文件 对 象 赋 给 f 〈( 见 @) 。 然 后 ， 
调用 csv.reader() 并 将 前 面 存 储 的 文件 对 象 作 为 实 参 传 递 给 它 ， 
从 而 创建 一 个 与 该 文件 相关 联 的 阅读 器 对 象 〈 见 贸 ) 。 这 个 阅读 器 
对 象 被 赋 给 了 reader 。 


模块 csv 包含 函数 next() ， 调 用 它 并 传 入 阅读 器 对 象 时 ， 它 将 返 
回 文 件 中 的 下 一 行 。 在 上 述 代码 中 ， 只 调用 了 next() 一 次 ， 因 此 
得 到 的 是 文件 的 第 一 行 ， 其 中 包含 文件 涉 〈 见 @) 。 将 返回 的 数据 
存储 到 header_row 中 。 如 你 所 见 ，header_row 包含 与 天 气相 关 
的 文件 头 ， 指 出 了 每 行 都 包含 哪些 数据 : 


['STATION', 'NAME', 'DATE', 'PRCP', 'TAVG', 'TMAX', 'TMIN'] 


reader 处 理 文件 中 以 把 号 分 隔 的 第 一 行 数据 ， 并 将 每 项 数据 都 作 
为 一 个 元 素 存储 在 列表 中 。 文 件 头 STATION 表示 记录 数据 的 气象 站 
的 编码 。 这 个 文件 头 的 位 置 表明 ， 每 行 的 第 一 个 值 都 是 气象 站 编 
码 。 文 件 头 NAME 指出 每 行 的 第 二 个 值 都 是 记录 数据 的 气象 站 的 名 
称 。 其 他 文件 头 则 指出 记录 了 哪些 信息 。 当 前 ， 我 们 最 关心 的 是 日 
期 (DATE ) 、 最 高 温度 CTMAX ) 和 最 低温 度 (TMIN ) 。 这 是 一 
个 简单 的 数据 集 ， 只 包含 降水 量 以 及 与 温度 相关 的 数据 。 你 自己 下 
载 天 气 数 据 时 ， 可 选择 涵盖 众多 测量 值 ， 如 风速 、 风 癌 以 及 详细 的 
降水 量 数据 。 


16.1.2 ”打印 文件 头 及 其 位 置 
人 将 列表 中 的 每 个 文件 头 及 其 位 置 打 
站 出 来 : 


sitka_highs.py 


--Snip-- 
with open(filename) as f: 


reader = csv.reader(f) 
header row = next(reader) 


@ for index, column header in enumerate(header row): 
print(index, column header) 


在 循环 中 ， 对 列表 调用 了 enumerate() ( 见 @) 来 获取 每 个 元 素 
的 索引 及 其 值 。〈 请 注意 ， 我 们 删除 了 代码 
行 print(header_row) ， 转 而 显示 这 个 更 详细 的 版 本 。) 


输出 如 下 ， 指 出 了 每 个 文件 头 的 索引 : 


STATION 
NAME 
DATE 
PRCP 
TAVG 
TMAX 
TMIN 


从 中 可 知 ， 日 斯 和 最 高 温度 分 别 存 储 在 第 三 列 和 第 六 列 。 为 研究 这 
些 数 据 ， 我 们 将 处 理 sitka_weather_07-2018_simple.csv 中 的 每 行 数 
据 ， 并 提取 其 中 索引 为 2 和 5 的 值 。 


16.1.3 ”提取 并 读 取 数据 


知道 需要 哪些 列 中 的 数据 后 ， 我 们 来 读 取 一 些 数据 。 首 先 ， 读 取 每 
天 的 最 高 温度 ; 


sitka_highs.py 


--Snip-- 

with open(filename) as f: 
reader = csv.reader(f) 
header row = next(reader) 


# 从 文件 中 获取 最 高 温度 。 
@ highs = [] 


@ for row in reader: 
3 high = int(row[5]) 
highs.append(high) 


print(highs) 


创建 一 个 名 为 highs 的 空 列表 ( 见 @) ， 再 过 历 文件 中 余下 的 各 行 
( 见 介 ) 。 阅 读 器 对 象 从 其 停留 的 地 方 继续 往 下 读 取 CSV 文 件 ， 


次 都 自动 返回 当前 所 处 位 置 的 下 一 行 。 由 于 已 经 读 取 了 文件 头 行 ， 
这 个 循环 将 从 第 二 行 开始 一 一 从 这 行 开始 包含 的 是 实际 数据 。 每 次 
执行 循环 时 ， 都 将 索引 5 处 (TMAX 列 ) 的 数据 附加 到 highs 末尾 

( 见 @) 。 在 文件 中 ， 这 项 数据 是 以 字符 串 格式 存储 的 ， 因 此 在 附 
有 末尾 前 ， 使 用 函数 int() 将 其 转换 为 数值 格式 ， 以 便 使 


highs 现在 存储 的 数据 如 下 : 


[62, 58, 70, 706, 67, 59, 58, 62, 66, 59, 56, 63, 65, 58, 56, 59, 64, 6 
61, 65, 65, 63, 59, 64, 65, 68, 66, 64, 67, 65] 


A 0 束 可 以 可 视 化 这 些 


16.1.4 ”绘制 温度 图 表 


为 可 视 化 这 些 温度 数据 ， 首 先 使 用 Matplotlib 创 建 一 个 显示 每 日 最 
高 温度 的 简单 图 形 ， 如 下 所 示 : 


sitka_highs.py 


import csyv 


import matplotlib.pyplot as plt 


filename = 'data/sitka weather 67-2618_ simple.csyv' 
with open(filename) as f: 
--_Snip 一 


# 根据 最 高 温度 绘制 图 形 。 

plt.style.use('seaborn') 

fig, ax = plt.subplots() 
@ ax.plot(highs, c='red') 


# 设置 图 形 的 格式 。 
@ ax.set title("2618 年 7 月 每 日 最 高 温度 "，fontsize=24) 
日 ax.set xlabel('', fontsize=16) 
ax.set_ylabel(" 温 度 (F)"，fontsize=16) 
ax.tick_ params(axis="'both', which="'major', labelsize=16) 


plt. show() 


将 最 高 温度 列表 传 给 plot() ( 见 @) ， 并 传递 c=' red ' 以 便 将 数 
据点 绘制 为 红色 。 (这 里 使 用 红色 显示 最 高 温度 ， 用 蓝 色 显示 最 低 
温度 。) 接 下 来 ， 设 置 了 一 些 其 他 的 格式 ， 如 名 称 和 字号 〈 见 
全 ) ， 这 些 都 在 第 15 章 介绍 过 。 鉴 于 还 没有 添加 日 期 ， 因 此 没有 给 
r 轴 添 加 标签 ， 但 ax.set_xlabel() 确实 修改 了 字号 ， 让 默认 标 
签 更 容易 看 清 信 。 图 16-1 显 示 了 绘制 的 图 表 : 一 个 简单 的 折线 图 ， 


显示 了 阿拉 斯 加 州 锡 特 卡 2018 年 7 月 的 每 日 最 高 温度 。 


3 Figure 1 
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图 16-1 阿拉 斯 加 州 锡 特 卡 2018 年 7 月 每 日 最 高 温度 折线 图 


16.1.5 模块 datetime 


下 面 在 图 表 中 添加 日 期 ， 使 其 更 有 用 。 在 天 气 数据 文件 中 ， 第 一 
日 期 在 第 二 行 ， 


"USN66625333","SITKA AIRPORT, AK US","2018-67-01","0.25",,"62","50" 


读 取 该 数据 时 ， 获 得 的 是 一 个 字符 串 ， 因 此 需要 想 办 法 将 字符 

串 "2618-7-1" 转换 为 一 个 表示 相应 日 期 的 对 象 。 为 创建 一 个 表示 
2018 年 7 月 1 日 的 对 象 ， 可 使 用 模块 datetime 中 的 方法 strptime() 
。 我 们 在 终端 会 话 中 看 看 strptime() 的 工作 原理 : 


>>> from datetime import datetime 

>>> first date = datetime.strptime('206018-67-061', '%Y-%m-%d"') 
>>> print(first date) 

2018-67-61 860:060:0600 


首先 导入 模块 datetime 中 的 datetime 类 ， 再 调用 方法 
strptime() ， 并 将 包含 所 需 日 期 的 字符 串 作 为 第 一 个 实 参 。 第 二 
个 实 参 后 诉 Python 如 何 设置 日 期 的 格式 。 在 这 里 ，'%Y- ' 让 Python 
将 字符 串 中 第 一 个 连 字符 前 面 的 部 分 视 为 四 位 的 年 份 ，'"%m- ' 让 
Python 将 第 二 个 连 字 符 前 面 的 部 分 视 为 表示 月 份 的 数 ，'%d" 让 
Python 将 字符 串 的 最 后 一 部 分 视 为 月 份 中 的 一 天 (1~31) 。 


方法 strptime() 可 接受 各 种 实 参 ， 并 根据 它们 来 决定 如 何 解 读 日 
期 。 表 16-1 列 出 了 这 样 的 一 些 实 参 。 


表 16-1 模块 datetime 中 设置 日 期 和 时 间 格 式 的 实 参 


含义 
星期 几 ， 如 Monday 


份 名 ， 如 January 


%m j 数 表示 的 月 份 〈01 一 12) 


用 数 表 示 的 月 份 中 的 一 天 〈01 一 31) 


立 的 年 份 ， 如 2019 


FE 份 ， 如 19 


才 制 的 小 时 数 〈00 一 23) 


制 的 小 时 数 〈01 一 12) 


16.1.6 ”在 图 表 中 添加 日 期 


现在 ， 可 以 通过 提取 日 期 和 最 高 温度 并 将 其 传递 给 plot() ， 对 温 
度 图 形 进行 改进 ， 如 下 所 示 : 


sitka_highs.py 


import csyv 
from datetime import datetime 


import matplotlib.pyplot as pilt 


filename = 'data/sitka weather 67-20618 simple.csvyv' 
with open(filename) as f: 

reader = csv.reader(f) 

header_ row = next(reader) 


# 从 文件 中 获取 日 期 和 最 高 温度 。 


@ dates, highs = [], [] 
for row in reader: 
@ current date = datetime.strptime(row[2], '%Y-%m-%d") 


high = int(row[5]) 
dates.append(current _ date) 
highs.append(high) 


# 根据 最 高 温度 绘制 图 形 。 
plt.style.use('seaborn') 
fig, ax = plt.subplots() 

@ ax.plot(dates, highs, c='red') 


# 设置 图 形 的 格式 。 
ax.set title("28618 年 7 月 每 日 最 高 温度 "，fontsize=24) 
ax.set xlabel('', fontsize=16) 
@ fig.autofmt xdate() 
ax.set_ylabel(" 温 度 (F)"，fontsize=16) 
ax.tick_ params(axis="'both', which="'major', labelsize=16) 


plt. show() 


我 们 创建 了 两 个 空 列表 ， 用 于 存储 从 文件 中 提取 的 日 期 和 最 高 温度 
( 见 @) 。 然 后 ， 将 包含 日 期 信息 的 数据 (row[8] ) 转换 

为 datetime 对 象 ( 见 @) ， 并 将 其 附加 到 列表 dates 末尾 。 在 全 
处 ， 将 日 期 和 最 高 温度 值 传递 给 plot() 。 在 @@ 处 ， 调 

用 fig.autofmt_xdate() 来 绘制 倾斜 的 日 期 标签 ， 以 免 其 彼此 重 
和合 。 图 16-2 显 示 了 改进 后 的 图 表 。 


2018 年 7 月 每 日 最 高 温度 
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和合 和 了 中 QI 三 
图 16-2 ”现在 网 表 的 z 轴 上 有 日 期 ， 含 义 更 丰 军 
16.1.7” 涵 兰 更 长 的 时 间 
设置 好 图 表 后 ， 我 们 来 添加 更 多 的 数据 ， 生 成 一 幅 更 复杂 的 锡 特 卡 
天 气 图 。 请 将 文件 sitka_weather_2018_simple.csv 复 制 到 本 章程 序 所 
在 的 文件 来 ， 该 文件 包含 整 年 的 锡 特 卡 天 气 数据 。 
现在 可 创建 覆盖 整 年 的 天 气 图 了 : 


sitka_highs.py 


--Snip-- 

filename = 'data/sitka weather 2018_ simple.csv" 
with open(filename) as f: 

--Snip-- 


# 设置 图 形 的 格式 。 


ax.set title("2618 年 每 日 最 高 温度 "，fontsize=24) 
ax.set xlabel('', fontsize=16) 
--Snip-- 


这 里 修改 了 文件 名 ， 以 使 用 数据 文件 
sitka_weather_2018_simple.csv( 见 @) ， 还 修改 了 图 表 的 标题 ， 以 
反映 其 内 容 的 变化 〈 见 外) 。 图 16-3 显 示 了 生成 的 图 形 。 


® Figure 1 


2018 年 7 月 每 日 最 高 温度 


温度 (F) 


全 人 所 中 届 三 四 
图 16-3 一 年 的 天 气 数 据 
16.1.8 ”再 绘制 一 个 数据 系列 


虽然 改进 后 的 图 表 已 经 显示 了 丰富 的 数据 ， 但 是 还 能 再 添加 最 低温 
度数 据 ， 使 其 更 有 用 。 为 此 ， 需 要 从 数据 文件 中 提取 最 低温 度 ， 并 
将 它们 添加 到 图 表 中 ， 如 下 所 示 : 


sitka_highs_lows.py 


--Snip-- 
filename = "Sitka_weather 20618 simple.csv" 
with open(filename) as f: 

reader = csv.reader(f) 

header row = next(reader) 


# 从 文件 中 获取 日 期 、 最 高 温度 和 最 低温 度 。 
@ dates, highs, lows = [],， [],， [] 
for row in reader: 
current date = datetime.strptime(row[2], '%Y-%m-%d') 
high = int(row[5]) 
@ low = int(row[6]) 
dates.append(current_date) 
highs.append(high) 
lows .append(low) 


# 根据 最 高 温度 和 最 低温 度 绘 制图 形 。 
plt.style.use('seaborn') 


fig, ax = plt.subplots() 
ax.plot(dates, highs, c="'red') 
日 ax.plot(dates, lows, c='blue') 


# 设置 图 形 的 格式 。 
@ ax.set _title("2618 年 每 日 最 高 温度 "，fontsize=24) 
--Snip-- 


在 斩 处 ， 添 加 空 列表 lows ， 用 于 存储 最 低温 度 。 接 下 来 ， 从 每 行 
的 第 七 列 〈“row[6] ) 提取 最 低温 度 并 存储 《〈 见 四 ) 。 在 全 处 , 添 
加 调用 plot () 的 代码 ， 以 使 用 蓝 色 绘制 最 低温 度 。 最 后 ， 修 改 标 


题 〈 见 加) 。 图 16-4 显 示 了 这 样 绘制 出 来 的 图 表 。 


2018 年 每 日 最 高 温度 


入 > \e , 
A De A A 


贷 所 中 届 革 回 


图 16-4 ”在 一 个 图 表 中 包含 两 个 数据 系列 
16.1.9 ”给 图 表 区 域 着 色 


添加 两 个 数据 系列 后 ， 就 可 以 知道 每 天 的 温度 范围 了 。 下 面 来 给 这 
个 图 表 做 最 后 的 修饰 ， 通 过 着 色 来 呈现 每 天 的 温度 范围 。 为 此 ， 将 
使 用 方法 fill_between() 。 它 接受 一 个 z 值 系 列 和 两 个 y 值 系 
列 ， 并 填充 两 个 y 值 系列 之 间 的 空间 : 


sitka_highs_l[ows.py 


--Snip-- 
# 根据 最 低温 度 和 最 高 温度 绘制 图 形 。 
plt.style.use('seaborn') 
fig, ax = plt.subplots() 
@ ax.plot(dates, highs, c='red', alpha=0.5) 


ax.plot(dates, lows, c='blue', alpha=0.5) 
@ ax.fill between(dates, highs, lows, facecolor='blue', alpha=0.1) 
--Snip-- 


@@ 处 的 实 参 alpha 指定 颜色 的 透明 度 。alpha 值 为 0 表示 完全 透 
明 ， 为 1 (默认 设置 ) 表示 完全 不 透明 。 通 过 将 alpha 设置 为 0.5， 
可 让 红色 和 蓝 色 折线 的 颜色 看 起 来 更 浅 。 


在 处， 同人 11_between() 传递 一 个 rz 值 系 列 〈( 列 表 dates ) ， 
以 及 两 个 y 值 系列 (highs 和 lows ) 。 实 参 facecolor 指 定 填充 区 域 
的 颜色 ， 还 将 alpha 设置 成 了 较 小 的 值 0. 1， 让 填充 区 域 将 两 个 数 
据 系 列 连接 起 来 的 同时 不 分 散 观 察 者 的 注意 力 。 图 16-5 显 示 了 最 高 
温度 和 最 低温 度 之 间 的 区 域 被 填充 后 的 图 表 。 


2018 年 每 日 最 高 温度 


A 人 吕 YL 9 入 A 
A A A A A A A 


全 《3 中 QI 三 加 
图 16-5 ”给 两 个 数据 集 之 间 的 区 域 着 色 
着 色 让 两 个 数据 集 之 间 的 区 域 变 得 更 显眼 了 。 
16.1.10 ”错误 检查 


我 们 应 该 能 够 使 用 任何 地 方 的 天 气 数据 来 运行 sitka_highs_lows.py 中 
的 代码 ， 但 有 些 气 象 站 收集 的 数据 种 类 不 同 ， 有 些 气 象 站 会 偶尔 出 
现 故 障 ， 未 能 收集 部 分 或 全 部 应 收集 的 数据 。 人 缺失 数据 可 能 引发 异 
币 ， 如 果 不 妥 善 处 理 ， 可 能 导致 程序 天 误 。 

例如 ， 来 看 看 生成 加 利 福 尼 亚 州 死亡 谷 的 温度 图 时 出 现 的 情况 。 请 
将 文件 death_valley_2018_simple.csv 复 制 到 本 章程 序 所 在 的 文件 

夹 。 


首先 通过 编写 代码 来 全 看 这 个 数据 文件 包含 的 文件 头 : 


death_valley_highs 


import csvlows.py_ 


filename = 'data/death valley 28618 simple.csv’ 
with open(filename) as f: 

reader = csv.reader(f) 

header row = next(reader) 


for index, column header in enumerate(header row): 
print(index, column header) 


输出 如 下 : 


8 STATION 


与 前 面 一 样 ， 日 期 也 在 索引 2 处 ， 但 最 高 温度 和 最 低温 展 分 别 在 索 
引 4 和 索引 5 处 ， 因 此 需要 修改 代码 中 的 索引 ， 以 反映 这 一 点 。 男 


外 ， 这 个 气象 站 没有 记录 平均 温度 ， 而 记录 了 TOBS ， 即 特定 时 扣 
的 温度 。 


为 演示 缺失 数据 时 将 出 现 的 状况 ， 我 故意 从 这 个 文件 中 删除 了 一 项 
温度 数据 。 下 面 来 修改 sitka_highs_ lows.py， 使 用 前 面 所 说 的 索引 来 
生成 死亡 谷 的 天 气 图 ， 看 看 将 出 现 什么 状况 : 


death_valley_highs_lows.py 


--Snip-- 
filename = "data/death valley 20618 simple.csv’ 
with open(filename) as f: 
--Snip-- 
# 从 文件 中 获取 日 期 、 最 高 温度 和 最 低温 度 。 
dates, highs, lows = [], [], [] 
for row in reader: 


current date = datetime.strptime(row[2], '%Y-%m-%d") 
high = int(row[4]) 
low = int(row[5]) 
dates.append(current date) 
--Snip-- 


在 @@ 处 ， 修 改 索 引 ， 使 其 对 应 于 这 个 文件 中 TMAX 和 TMIN 的 位 置 。 
运行 这 个 程序 时 出 现 了 错误 ， 如 下 述 输出 的 最 后 一 行 所 示 : 


Traceback (most recent call last): 
File "death valley highs lows.py", line 15, in <module> 
high = int(row[4]) 


ValueError: invalid literal for int() with base 106: "' 


该 traceback 指 出 ，Python 无 法 处 理 其 中 一 天 的 最 高 温度 ， 因 为 无 法 
将 空 字符 串 〈'" ' ) 转换 为 整数 。 我 们 只 要 看 一 下 文件 
death_valley_2018_simple.csv， 就 知道 缺失 了 哪 项 数据 ， 但 这 里 不 
这 样 做 ， 而 是 直接 对 缺失 数据 的 情形 进行 处 理 。 


为 此 ， 在 从 CSV 文 件 中 读 取 值 时 执行 错误 检查 代码 ， 对 可 能 出 现 的 
异常 进行 处 理 ， 如 下 所 示 : 


death_valley_highs_lows.py 


--Snip-- 
filename = "data/death_valley_ 20618 simple.csv’ 
with open(filename) as f: 
--Snip-- 
for row in reader : 
current date = datetime.strptime(row[2], '%Y-%m-%d") 
@ try: 
high = int(row[4]) 
low = int(row[5]) 
except ValueError: 
@ print(f"Missing data for {current date}") 
日 else: 
dates.append(current date) 
highs.append(high) 
lows.append(low) 


# 根据 最 高 温度 和 最 低温 度 绘制 图 形 。 
--Snip-- 


# 设置 图 形 的 格式 。 
@ title = "2618 年 每 日 最 高 温度 和 最 低温 度 \n 美 国 加 利 福 尼 亚 州 死亡 谷 " 
ax.set title(title, fontsize=20) 
ax.set xlabel('', fontsize=16) 
--Snip-- 


对 于 每 一 行 ， 都 尝试 从 中 提取 日 期 、 最 高 温度 和 最 低温 度 〈( 见 
@) 。 只 要 缺失 其 中 一 项 数据 ，Python 就 会 引发 ValueError 异 
常 。 我 们 这 样 进行 处 理 : 打印 一 条 错误 消息 ， 指 出 缺失 数据 的 日 期 
( 见 @) 。 打印 错误 消息 后 ， 循 环 将 接着 处 理 下 一 行 。 如 果 获 取 特 
定 日 期 的 所 有 数据 时 没有 发 生 错 误 ， 就 运行 else 代码 块 ， 将 数据 


附加 到 相应 列表 的 末尾 ( 见 @) 。 这 里 绘图 时 使 用 的 是 有 关 另 一 个 
地 方 的 信息 ， 因 此 修改 标题 以 指出 这 个 地 方 。 因 为 标题 更 长 ， 所 以 
我 们 缩小 了 字号 〈 见 @@) 。 


如 果 现 在 运行 death_valley_highs_lows.py， 将 发 现 缺 失 数据 的 日 期 
具有 一 人 


Missing data for 2018-62-18 60:60:060 


受 善 地 处 理 错误 后 ， 代 码 能 够 生成 图 形 并 忽略 缺失 数据 的 那天 。 图 
16-6 显 示 了 绘制 出 的 图 形 。 


2018 年 每 日 最 高 温度 和 最 低温 度 
美国 加 利 福 尼 亚 州 死亡 谷 


入 > \e 只 
A A A A A 


便捷 了 中 届 芭 加 


图 16-6 ”死亡 谷 每 天 的 最 高 温度 和 最 低温 度 


将 这 个 图 表 与 锡 特 卡 的 图 表 进 行 比较 可 知 ， 总 体 而 言 ， 死 亡 谷 比 阿 
拉 斯 加 东南 部 暖和 ， 这 符合 预期 。 同 时 ， 死 亡 谷 沙漠 中 每 天 的 温差 
也 更 大 一 一 从 着 色 区 域 的 高 度 可 以 看 出 这 一 点 。 


你 使 用 的 很 多 数据 集 都 可 能 缺失 数据 、 格 式 不 正确 或 数据 本 号 不 正 
确 。 对 于 这 样 的 情形 ， 可 使 用 本 书 前半 部 分 介绍 的 工具 来 处 理 。 在 
这 里 ， 使 用 了 一 个 try-except-else 代码 块 来 处 理 数据 缺失 的 问 

题 。 在 有 些 情况 下 ， 需 要 使 用 continue 来 跳 过 一 些 数据 ， 或 者 使 

用 remove() 或 del 将 已 提取 的 数据 删除 。 只 要 能 进行 精确 而 有 意 

义 的 可 视 化 ， 采 用 任何 管用 的 方法 都 是 可 以 的 。 


16.1.11 自己 动手 下 载 数据 
如 宋 你 想 目 己 下 载 天 气 数据 ， 可 采取 如 下 步骤 。 
(1) 访问 网 站 NOAA Climate Data Online。 在 Discover Data By 部 分 ， 


单 击 Search Tool。 在 下 拉 列 表 Select a Dataset 中 ， 选 择 Daily 
Summaries 。 


(2) 选择 一 个 日 期 范围 ， 在 Search For 下 拉 列 表 中 ZIP Codes， 输 入 你 


感 兴趣 地 区 的 邮政 编码 ， 再 单 击 Search 按 钮 。 


(3) 在 下 一 个 页 面 中 ， 你 将 看 到 指定 地 区 的 地 图 和 相关 信息 。 单 击 
地 区 名 下 方 的 View Full Details 或 单 击 地 图 再 单 击 Full Details。 


(4) 回 下 滚动 并 单 击 Station List， 以 显示 该 地 区 的 气象 站 ， 再 选择 一 
个 气象 站 并 单 击 Add to Cart。 虽 然 这 个 网 站 使 用 了 购物 车 图 标 ， 但 
提供 的 数据 是 免费 的 。 单 击 右上 角 的 购物 车 。 


(5) 在 Select the Output 中 选择 Custom GHCN-Daily CSV。 确 认 日 期 
范围 无 误 后 单 击 Continue。 


(6) 在 下 一 个 页 面 中 ， 可 选择 要 下 载 的 数据 类 型 。 可 以 只 下 载 一 种 
数据 《〈 如 气温 ) ， 也 可 以 下 载 该 气象 站 提供 的 所 有 数据 。 做 出 选择 
后 单 击 Continue。 


(7) 在 最 后 一 个 页 面 ， 你 将 看 到 订单 小 结 。 请 输入 你 的 电子 邮箱 地 
址 ， 再 单 击 Submit Order。 你 将 收 到 一 封 确认 邮件 ， 指 出 收 到 了 你 
几 分 钟 后 ， 你 将 收 到 另 一 封 邮 件 ， 其 中 包含 用 于 下 载 数据 


你 下 载 的 数据 与 本 节 处 理 的 数据 有 类 似 的 结构 ， 但 包含 的 文件 头 可 
能 不 同 。 然 而 ， 只 要 按 本 节 介 绍 的 步骤 做 ， 就 能 对 你 感 兴趣 的 数据 
进行 可 视 化 。 


动手 试 一 斌 


练习 16-1: 锡 特 卡 的 降雨 量 ” 锡 特 卡 属于 温带 雨林 ， 降 水 量 

非常 丰富 。 在 数据 文件 sitka_weather_ 2018_simple.csv 中 ， 文 件 
头 PRCP 表 示 的 是 每 日 降水 量 。 请 对 这 列 数 据 进 行 可 视 化 。 如 

末 你 想 知 道 沙 漠 的 降水 量 有 多 低 ， 可 针对 死亡 谷 完成 同样 的 练 
5 


练习 16-2: 比较 锡 特 卡 和 和 死亡 谷 的 明度 ”在 有 关 锡 特 卡 和 和 死 
亡 谷 的 图 表 中 ， 温 度 刻 度 反 映 了 数据 范围 的 不 同 。 为 准确 比较 
锡 特 卡 和 死亡 谷 的 温度 范围 ， 需 要 在 y 轴 上 使 用 相同 的 刻度 。 
为 此 ， 请 修改 图 16-5 和 图 16-6 所 示 图 表 的 y 轴 设 置 ， 对 锡 特 卡 
和 死亡 谷 的 温度 范围 进行 直接 比较 (也 可 对 任何 两 个 地 方 的 温 


度 范 围 进行 比较 ) 。 


练习 16-3: 旧金山 ”旧金山 的 温度 更 接近 锡 特 卡 还 是 死亡 谷 
呢 ? 为 进行 比较 ， 可 下 载 一 些 有 关 旧 金山 的 温度 数据 ， 并 据 此 
生成 包含 最 高 过 度 和 最 低温 度 的 图 表 。 


练习 16-4: 自动 索引 本 节 以 人 硬 编码 的 方式 指定 了 TMIN 和 
TMAX 列 的 索引 。 请 根据 文件 头 行 确 定 这 些 列 的 索引 ， 让 程序 
同时 适用 于 锡 特 卡 和 死亡 谷 。 另 外 ， 请 根据 气象 站 的 名 称 自动 
生成 图 表 的 标题 。 


练习 16-5: 探索 ”生成 一 些 图 表 ， 对 你 好 奇 的 任何 地 方 的 其 他 
天 气 数据 进行 研究 。 


16.2 ”制作 全 球 地 震 散 点 图 : JSON 格 式 


在 本 节 中 ! ， 你 将 下 载 一 个 数据 集 ， 其 中 记录 了 一 个 月 内 全 球 发 生 
的 所 有 地 震 ， 再 制作 一 幅 散 点 图 来 展示 这 些 地 许 的 位 置 和 谋 级 。 这 
些 数据 是 以 JSON 格 式 存 储 的 ， 因 此 要 使 用 模块 json 来 处 理 。 
Plotly 提 供 了 根据 位 置 数 据 绘制 地 图 的 工具 ， 适 合 初 学 者 使 用 。 你 
将 使 用 它 来 进行 可 视 化 并 指出 全 球 的 地 震 分 布 情况 。 


1 本 节 为 陶 俊 杰 根 据 原作 编写 。 编者 注 

16.2.1 ”地震 数 据 
请 将 文件 eq_data_1_day_m1.json 复 制 到 存储 本 章程 序 的 文件 夹 中 。 
地 震 是 以 里 氏 震 级 度量 的 ， 而 该 文件 记录 了 【截至 写作 本 节 时 ) 最 
近 24 小 时 内 全 球 发 生 的 所 有 不 低 于 1 级 的 地 震 。 

16.2.2 ”查看 JSON 数 据 


如 果 打 开 文 件 eq_data_1_day_m1.json， 你 将 发 现 其 内 容 密 密 麻 麻 ， 
难以 阅读 : 


":"FeatureCollection","metadata":{"generated":155063614616860,... 
":"Feature","properties":{"mag":1.2,"place":"11lkm NNE of Nor... 
":"Feature","properties": ae a sh Loe: 7 OKm NNW of Ayn... 
":"Feature","properties":{"mag":3.6,"place":"126km SSE of Co... 
":"Feature","properties":{"mag":2.1, ce TK NNW of Teh... 


":"Feature","properties":{"mag":4,"place":"57km SSW of Kakto... 


这 些 数 据 适 合 机 器 而 不 是 人 来 读 取 。 不 过 可 以 看 到 ， 这 个 文件 包含 
一 些 字 典 ， 还 有 一 些 我 们 感 兴趣 的 信息 ， 如 震级 和 位 置 。 


模块 json 提供 了 各 种 探索 和 处 理 JSON 数 据 的 工具 ， 其 中 一 些 有 助 
于 重新 设置 这 个 文件 的 格式 ， 让 我 们 能 够 更 清楚 地 查看 原始 数据 ， 
继而 决定 如 何以 编程 的 方式 来 处 理 。 


我 们 先 加 载 这 些 数据 并 将 其 以 易于 阅读 的 方式 显示 出 来 。 这 个 数据 
文件 很 长 ， 因 此 不 打印 出 来 ， 而 是 将 数据 写 入 另 一 个 文件 ， 再 打开 
该 文件 并 轻松 地 在 数据 中 导航 : 

eq_explore_data.py 


import json 


# 探索 数据 的 结构 。 
filename = 'data/eq data 1 day _ m1.json' 
with open(filename) as f: 

@ all eq data = json.1load(f) 


@ readable file = 'data/readable eq data.json' 
with open(readable file, 'w') as f: 
日 json.dump(all eq data, f, indent=4) 


首先 导入 模块 json ， 以 便 恰 当地 加 载 文件 中 的 数据 ， 并 将 其 存储 
到 all_eq_data 中 ( 见 @) 。 子 数 json.1load() 将 数据 转换 为 
Python 能 够 处 理 的 格式 ， 这 里 是 一 个 庞大 的 字典 。 在 处， 创建 一 
个 文件 ， 以 便 将 这 些 数据 以 易于 阅读 的 方式 写 入 其 中 。 函 

数 json.dump() 接受 一 个 JSON 数 据 对 象 和 一 个 文件 对 象 ， 并 将 数 
据 写 入 这 个 文件 中 ( 见 @) 。 人 参数 indent=4 让 dump() 使 用 与 数据 
结构 匹配 的 缩 进 量 来 设置 数据 的 格式 。 


如 果 你 现在 查看 目录 data 并 打开 其 中 的 文件 readable_eq_data.json， 
将 发 现 其 开头 部 分 像 下 面 这 样 : 


readable_eq_data.json 


"type": "FeatureCollection", 
"metadata": { 
"generated": 1556361461666， 
"url": "https://earthquake.usgs.gov/earthquakes/.../1.0 day. 


"title": "USGS Magnitude 1.6+ Earthquakes, Past Day", 


@ "features": [ 
--Snip-- 


这 个 文件 的 开头 是 一 个 键 为 "metadata'" 的 片段 ( 见 @)， ， 指 出 了 
这 个 数据 文件 是 什么 时 候 生成 的 ， 以 及 能 够 在 网 上 的 什么 地 方 找 
到 。 它 还 包含 适合 人 类 阅读 的 标题 以 及 文件 中 记录 了 多 少 次 地 震 : 
在 过 去 的 24 小 时 内 ， 发 生 了 158 次 地 震 。 


这 个 geoJSON 文 件 的 结构 适合 存储 基于 位 置 的 数据 。 数 据 存储 在 一 
个 与 键 "features" 相关 联 的 列表 中 ( 见 @) 。 这 个 文件 包含 的 是 
地 震 数 据 ， 因 此 列表 的 每 个 元 系 都 对 应 一 次 地 震 。 这 种 结构 可 能 
点 令 人 迷惑 ， 但 很 有 用 ， 让 地 质 学 家 能 够 将 有 关 每 次 地 震 的 任意 数 
量 信息 存储 在 一 个 字典 中 ， 再 将 这 些 字 典 放 在 一 个 大 型 列表 中 。 


我 们 来 看 看 表示 特定 地 震 的 字典 : 


readable_eq_data.json 


"type": "Feature", 
"properties": { 
"mag": 0.96， 
--Snip-- 
"title": "M 1.6 - 8km NE of Aguanga, CA" 
}, 
"geometry": { 
"type": "Point", 


"coordinates": [ 
-116.7941667， 
33.4863333， 
3.22 

] 


": "ci37532978" 


键 "properties" 关联 到 了 与 特定 地 宕 相关 的 大 量 信息 ( 见 @) 。 


我 们 关心 的 主要 是 与 键 "mag"” 相 关联 的 地 震 震 级 以 及 地 震 的 标题 ， 
因为 后 者 很 好 地 概述 了 地 震 的 震级 和 位 置 ( 见 @) 。 


键 "geometry" 指出 了 地 震 发 生 在 什么 地 方 ( 见 人 @) ， 我 们 需要 根 
据 这 项 信息 将 地 震 在 散 点 图 上 标 出 来 。 在 与 键 "coordinates" 相 
站 


这 个 文件 的 租 套 层级 比 我 们 编写 的 代码 多 。 如 果 这 让 你 感到 迷惑 ， 
也 不 用 担心 ，Python 将 符 你 处 理 大 部 分 复杂 的 工作 。 我 们 每 次 只 会 
处 理 一 两 个 能 套 层 级 。 我 们 将 首先 提取 过 去 24 小 时 内 发 生 的 每 次 地 
震 对 应 的 字典 。 

注意 ”说 到 位 置 时 ， 我 们 通常 先 说 纬度 、 再 说 经 度 ， 这 种 习 
惯 形成 的 原因 可 能 是 人 类 先 有 发现 了 纬度 ， 很 久 后 才 有 经 度 的 概 
念 。 然 而 ， 很 多 地 质 学 框架 都 先 列 出 经 上 度 、 后 列 出 纬度 ， 因 为 
这 与 数学 约定 (7,Y) 一 致 。geoJSON 格 式 遵循 (经 度 , 纬度 ) 的 约 
定 ， 但 在 使 用 其 他 框 如 时 ， 获 悉 其 遵循 的 约定 很 重要 。 


16.2.3 ”创建 地 震 列 表 
首先 ， 创 建 一 个 列表 ， 其 中 包含 所 有 地 震 的 各 种 信息 : 


eq_explore_data.py 


import json 
# 探索 数据 的 结构 。 
filename = 'data/eq data 1 day_m1.json' 
with open(filename) as f: 
all eq data = json.1oad(f) 


all eq dicts = all eq datal[l 'features '] 
print(len(all eq dicts)) 


我 们 提取 与 键 'features' 相关 联 的 数据 ， 并 将 其 存储 
到 all_eq_dicts 中 。 我 们 知道 ， 这 个 文件 记录 了 158 次 地 震 。 下 
面 的 输出 表明 ， 我 们 提取 了 这 个 文件 记录 的 所 有 地 震 : 


注意 ， 我 们 编写 的 代码 很 短 。 格 式 良好 的 文件 readable_eq_data.json 
包含 超过 6000 行 内 容 ， 但 只 需 几 行 代 码 ， 就 可 读 取 所 有 的 数据 并 将 
其 存储 到 一 个 Python 列表 中 。 下 面 将 提取 所 有 地 震 的 震级 。 


16.2.4 提取 震级 


有 了 包含 所 有 地 震 数据 的 列表 后 ， 葡 可 过 有 历 这 个 列表 ， 从 中 提取 上 所 
需 的 数据 。 下 面 来 提取 每 次 地 震 的 震级 : 


eq_explore_data.py 


--Snip-- 
all eq dicts = all eq data[ 'features '] 


@ mags = [] 


for eq _ dict in all eq dicts: 
@ mag = eq_dict[ "properties ' ][ mag '] 
mags.append(mag) 


print(mags[:16]) 


我 们 创建 了 一 个 空 列 表 ， 用 于 存储 地 震 震 级 ， 再 过 历 列 表 
all_eq_dicts( 见 @) 。 每 次 地 震 的 震级 都 存储 在 相应 字典 

的 'properties' 部 分 的 "mag ' 键 下 〈 见 人 @) 。 我 们 依次 将 地 震 震 
级 赋 给 变量 mag ， 再 将 这 个 变量 附加 到 列表 mags 末尾 。 


为 确定 提取 的 数据 是 否 正 确 ， 打 印 前 10 次 地 震 的 震级 : 


[6.96，1.2，4.3，3.6，2.1，4，1.66，2.3，4.9，1.8] 


我 们 将 提取 每 次 地 震 的 位 置信 息 ， 然 后 就 可 以 绘制 地 寡 散 
扩 图 了 了。 


16.2.5 ”提取 位 置 数 据 


位 置 数 据 存 储 在 "geometry" 键 下 。 在 "geometry" 键 关 联 的 字典 
中 ， 有 一 个 "coordinates" 键 ， 它 关联 到 一 个 列表 ， 而 列表 中 的 
前 两 个 值 为 经 度 和 纬度 。 下 面 演示 了 如 何 提取 位 置 数据 : 


eq_explore_data.py 


--Snip-- 
all eq dicts = all eq _data[ 'features '] 


mags, titles, lons, lats = [], [], [], [] 
for eq dict in all eq dicts: 
mag = eq_dict['properties']['mag'] 
title = eq dict['properties']['title'] 
lon = eq dict['geometry']['coordinates'][08] 
lat = eq dict['geometry']['coordinates'][1] 
mags .append(mag) 
titles.append(title) 
lons.append(lon) 
lats.append(1lat) 


print(mags[:16]) 
print(titles[:2]) 
print(lons[:5]) 
print(lats[:5]) 


我 们 创建 了 用 于 存储 位 置 标题 的 列表 titles ， 来 提取 字 

典 'properties' 里 'title' 键 对 应 的 值 ( 见 @) ， 以 及 用 于 存储 
经 度 和 纬度 的 列表 。 代 码 eq_dict['" geometry ' ] 访问 

与 "geometry" 键 相 关联 的 字典 ( 见 @) 。 第 二 个 键 
('coordinates' ) 提取 与 "coordinates" 相关 联 的 列表 ， 而 索 
引 0 提 取 该 列表 中 的 第 一 个 值 ， 即 地 震 发 生 位 置 的 经 度 。 


打印 前 5 个 经 度 和 纬度 时 ， 输 出 表明 提取 的 数据 是 正确 的 : 


[6.96，1.2，4.3，3.6，2.1，4，1.66，2.3，4.9，1.8] 

['M1.6 - 8km NE of Aguanga, CA', 'M 1.2 - 11Kkm NNE of North Nenana, A 
[-116.7941667，-148.9865，-74.2343，-161.6801，-118.5316667] 
[33.4863333，64.6673，-12.1025，54.2232，35.3698333 ] 


有 了 这 些 数据 ， 就 可 以 绘制 地 震 散 点 图 了 。 
16.2.6 ”绘制 震级 散 点 图 


有 了 前 面 提取 的 数据 ， 就 可 以 绘制 可 视 化 图 了 。 首 先 要 实现 一 个 简 
单 的 震级 散 点 图 ， 在 确保 显示 的 信息 正确 无 误 之 后 ， 我 们 再 将 注意 
力 转向 样式 和 外 观 方 面 。 绘 制 初始 散 点 图 的 代码 如 下 : 


eq_world_map.py 


@ import plotly.express as px 


fig = px.scatter( 
Xx=lons,， 
y=1lats, 
labels={"x": "经 度 "，"y 
Fange_Xx=[-2066，266]， 
range_y=[-98，96]， 
width=866， 
height=866， 
title=" 全 球 地 震 散 点 图 "， 


© ) 
@ fig.write html("global earthquakes.html") 
@ fig.show() 


首先 ， 导 入 plotly.express ， 用 别名 px 表示 。Plotly Express 是 
Plotly 的 高 级 接口 ， 简 单 易 用 ， 语 法 与 Matplotlib 类 似 〈( 见 @) 。 然 
后 ， 调 用 px.scatter 函数 配置 参数 创建 一 个 fig 实例 ， 分 别 设置 x 
轴 为 经 度 [范围 是 [-266，266] (扩大 空间 ， 以 便 完整 显示 东西 
经 180° 附 近 的 地 震 散 点 ) 」]、y 轴 为 纬度 [范围 是 [-986，96] ] ， 
设置 散 点 图 显示 的 宽度 和 高 度 均 为 800 像 素 ， 并 设置 标题 为 “全 球 地 
震 散 点 图 ”( 见 @) 。 


只 用 14 行 代码 ， 简 单 的 散 点 图 就 配置 完成 了 ， 这 返回 了 一 个 fig 对 
象 。fig.write_html 方法 可 以 将 可 视 化 图 保存 为 html 文 件 。 在 文 
件 夹 中 找到 global_earthquakes.html 文 件 ， 用 浏览 器 打开 即 可 〈 见 


人 全) 。 另 外， 如 果 使 用 Jupyter Notebook， 可 以 直接 使 用 fig .show 
方法 直接 在 notebook 单 元 格 显 示 散 点 图 ( 见 @) . 


局 部 效果 如 下 图 所 示 : 


图 16-7 显示 24 小 时 内 所 有 地 震 的 简单 散 点 图 


可 对 这 幅 散 扣 图 做 大 量 修改 ， 使 其 更 有 意义 、 更 好 懂 。 下 面 束 来 做 
些 这 样 的 修改 。 


16.2.7 男 一 种 指定 图 表 数 据 的 方式 


配置 这 个 图 表 前 ， 先 来 看 看 为 一 种 稍微 不 同 的 指定 Plotly 图 表 数 据 
的 方式 。 当 前 ， 经 纬度 数据 是 手动 配置 的 : 


--Snip-- 
xXx=lons,， 
y=lats, 
labels={"x": "经 度 " 


--Snip-- 


这 是 在 Plotly Express 中 给 图 表 定 义 数 据 的 最 简单 方式 之 一 ， 但 在 数 
据 处 理 中 并 不 是 最 佳 的 。 下 面 是 另 一 种 给 图 表 定 义 数 据 的 等 效 方 
式 ， 需 要 使 用 pandas 数 据 分 析 工 具 。 首 先 创 建 一 个 DataFrame ， 将 
需要 的 数据 封装 起 来 : 


import pandas as pd 


data = pd.DataFrame( 
data=zip(L1ons，1lats，titles，mags)，columns=[ "经 度 "，" 纬 度 " ，" 位 


) 
data.head() 


然后 ， 参 数 配 置 方 式 可 以 变更 为 : 


在 这 种 方式 中 ， 所 有 有 关 数 据 的 信息 都 以 键 值 对 的 形式 放 在 一 个 字 
典 中 。 如 果 在 eq_plotpy 中 使 用 这 些 代 码 ， 生 成 的 图 表 是 一 样 的 。 
相 比 于 前 一 种 格式 ， 这 种 格式 让 我 们 能 够 无 颖 衔接 数据 分 机， 并 且 
更 轻松 地 进行 定制 。 


16.2.8 定制 标记 的 尺寸 

确定 如 何 改进 散 点 图 的 样式 时 ， 应 着 重 于 让 要 传达 的 信息 更 清晰 。 
当前 的 散 点 图 显示 了 每 次 地 震 的 位 置 ， 但 没有 指出 震级 。 我 们 要 让 
观察 者 迅速 获悉 最 严重 的 地 震 发 生 在 什么 地 方 。 


为 此 ， 根 据 地 震 的 震级 设置 其 标记 的 矿 才 : 


eq_world_map.py 


fig = px.scatter( 


uale, 
x=" 经 度 "， 
y=" 纬 度 "， 
range_x=[-266，266]， 
range_y=[-986，96]， 
width=866， 
height=866， 
title=" 全 球 地 震 散 点 图 "， 
@ size=" 震 级 "， 
@ Size_max=16， 


fig.write html("global earthquakes.html") 
fig.show() 


Plotly Express 文 持 对 数据 系列 进行 定制 ， 这 些 定制 都 以 参数 表示 。 
这 里 使 用 了 size 参数 来 指定 散 点 图 中 每 个 标记 的 尺寸 ， 我 们 只 需 
要 将 前 面 data 中 的 "震级 " 字段 提供 给 e 参数 即 可 〈( 见 @@) 。 
另外 ， 标 记 尺 寸 默认 为 20 像 素 ， 还 可 以 通过 size_max=16 将 最 大 
显示 尺寸 缩放 到 10 〈 见 外) 。 


如 果 运 行 这 些 代 码 ， 将 看 到 关 似 于 图 16- 8 所 示 的 散 点 图 。 这 比 前 面 
的 散 点 图 好 多 了 ， 但 还 有 很 大 的 改进 空间 。 


file:///Users, /eric/pec_2e/chapter_16/global_earthquakes.html 


Global Earthquakes 


图 16-8 现在 散 点 图 显示 了 地 震 的 震级 

16.2.9 ”定制 标记 的 颜色 

我 们 还 可 以 定制 标记 的 颜色 ， 以 呈现 地 震 的 严重 程度 。 执 行 这 些 修 
改 前 ， 将 文件 eq_data_30_day_m1.json 复 制 到 你 的 数据 目录 中 ， 它 
包含 30 天 内 的 地 震 数 据 。 通 过 使 用 这 个 更 大 的 数据 集 ， 绘 制 出 来 的 
地 震 散 点 图 将 有 趣 得 多 。 


下 面 沉 示 了 如 何 使 用 渐变 来 呈现 地 震 震 级 : 


eq_world_map.py 


@ filename = 'data/eq data 30 day _ m1.json' 

--Snip-- 

fig = px.scatter( 
data， 
Xx= "经度 "， 
y= "纬度 "， 
range_Xx=[-206，266]， 
range_y=[-986，96]， 
width=866， 
height=866， 
title=" 全 球 地 震 散 点 图 "， 
size=" 震 级 "， 
size_ max=10, 


@ color=" 震 级 "， 


) 


--Snip-- 


首先 修改 文件 名 ， 以 使 用 30 天 的 数据 集 〈 见 @@) 。 为 了 让 标记 的 震 
级 按照 不 同 的 颜色 显示 ， 只 需要 配置 color=" 震 级 " 即 可 。 默 认 的 
视觉 映射 图 例 渐变 色 范 围 是 从 赣 到 红 再 到 鞭 ， 数 值 越 小 则 标记 越 
复 ， 而 数值 越 大 则 标记 越 黄 〈 见 仿 ) 。 


如 果 现 在 运行 这 个 程序 ， 你 看 到 的 散 点 图 将 漂亮 得 多 。 如 图 16-9 所 
示 ， 渐 变 的 颜色 指出 了 地 震 的 严重 程度 。 通 过 在 散 点 图 上 显示 大 量 
的 地 震 ， 可 将 板块 边界 大 致 呈现 出 来 ! 


图 16-9 ”使 用 颜色 和 尺寸 呈现 震级 的 30 天 地 震 散 点 图 


16.2.10 ”其 他 渐变 


Plotly Express 有 大 量 的 渐变 可 供 选 择 。 要 获悉 有 哪些 渐变 可 供 使 
用 ， 请 使 用 文件 名 show_color_scales.py 保 存 下 面 这 个 简短 的 程序 : 


show_color_scales.py 


import plotly.express as px 


for key in px.colors.named colorscales(): 
print(key) 


Plotly Express 将 渐变 存储 在 模块 colors 中 。 这 些 渐变 是 在 列 
表 px.colors.named_colorscales() 中 定义 的 。 下 面 的 输出 列 出 
了 可 供 你 使 用 的 所 有 渐变 : 


--Snip-- 


greys 
hot 


inferno 
jet 
magenta 
magma 
--Snip-- 


请 尝试 使 用 这 些 渐变 其 实 上 映射 到 一 个 颜色 列表 。 使 
用 px.colors.diverging.RdYlGn[ ::-1] 可 以 将 对 应 颜色 的 配色 
列表 反 转 。 


注意 ”Plotly 除 了 有 px.colors.diverging 表示 连续 变量 的 
配色 方案 ， 还 有 px.colors.sequential 和 
px.colors.qualitative 表示 离散 变量 。 随 便 挑 一 种 配色 ， 
例如 px.colors.qualitative.Alphabet ， 你 将 看 到 渐变 是 
如 何 定义 的 。 每 个 渐变 都 有 起 始 色 和 终止 色 ， 有 些 渐变 还 定义 
es Plotly 会 在 这 些 定义 好 的 颜色 之 间 插 入 
夭亡 。 


16.2.11 添加 鼠标 指 和 同时 显示 的 文本 
为 完成 这 幅 散 点 图 的 绘制 ， 我 们 将 添加 一 些 说 明 性 文本 ， 在 你 将 鼠 


标 指向 表示 地 展 的 标记 时 显示 出 来 。 除 了 默认 显示 的 经 度 和 纬度 
外 ， 还 将 显示 震级 以 及 地 震 的 大 致 位 置 : 


eq_world_map.py 


fig = px.scatter( 

data, 

x=" 经 度 "， 

y=" 纬 度 "， 
range_Xx=[-206，266]， 
Fange_y=[-986，96]， 
width=866， 
height=866， 
title=" 全 球 地 震 散 点 图 "， 
size=" 震 级 "， 

size max=10, 
color=" 震 级 "， 
hover_name=" 位 置 "， 


) 


fig.write html("global earthquakes.html") 
fig.show() 
--Snip-- 


Plotly Express 的 操作 非常 简单 ， 只 需要 将 hover_name 参数 配置 
为 data 的 "位 置 " 字段 即 可 。 


太 令 人 震惊 了 ! 通过 编写 大 约 40 行 代码 ， 我 们 就 绘制 了 一 幅 漂 亮 的 
全 球 地 震 活动 散 点 图 ， 并 通过 30 天 地 震 数 据 大 致 展示 了 地 球 的 板块 
结构 。Plotly Express 提 供 了 众多 定制 可 视 化 外 观 和 行为 的 方式 。 使 
用 它 提供 的 众多 选项 ， 可 让 图 表 和 散 点 图 准确 地 显示 你 所 需 的 信 


动手 试 一 斌 


练习 16-6: 重 构 “在 从 all_ eq _dicts 中 提取 数据 的 循环 中 ， 
使 用 了 变量 来 指向 震级 、 经 度 、 纬 度 和 标题 ， 再 将 这 些 值 分 别 
附加 到 相应 列表 的 末尾 。 这 骨 在 清晰 地 演示 如 何 从 JSON 文 件 
中 提取 数据 ， 但 并 非 必 须 这 样 做 。 你 也 可 以 不 使 用 这 些 临 时 变 
量 ， 而 是 直接 从 eq_dict 中 提取 这 些 值 ， 并 将 其 附加 到 相应 的 
ee 这 样 做 将 缩短 这 个 循环 的 循环 体 ， 使 其 只 包含 4 行 


练习 16-7: 自动 生成 标题 ”本 节 定 义 my_layout 时 以 手工 方 
式 指 定 标题 ， 这 意味 着 每 次 变更 源 文 件 时 ， 都 需要 修改 标题 。 
你 可 以 不 这 样 做 ， 而 是 使 用 JSON 文 件 中 元 数据 (metadata) 部 
分 的 数据 集 标题 。 为 此 ， 可 提取 这 个 值 ， 将 其 赋 给 一 个 变量 ， 
并 在 定义 my_layout 时 使 用 这 个 变量 来 指定 散 点 图 的 标题 。 


练习 16-8: 最 近 发 生 的 地 震 ”请 在 本 书 配套 资源 中 找到 关于 
最 近 1 小 时 、1 天 、7 天 和 30 天 内 地 震 信 息 的 数据 文件 (截至 本 
书 出 版 时 ， 参 见 文件 夹 chapter_16/Excercise16-8) 。 请 使 用 其 
中 一 个 数据 集 ， 绘 制 一 幅 散 点 图 来 展示 最 近 发 生 的 地 震 。 


练习 16-9: 全 球 火 灾 ”在 本 章 的 配套 资源 中 ， 有 一 个 名 为 
world_fires_1 day.csv 的 文件 。 它 包含 了 有 关 全 球 各 地 发 生 的 火 
灾 信 息 ， 包 括 经 度 、 纬 度 和 火灾 强度 〈brightness) 。 使 用 16.1 


节 介 绍 的 数据 处 理 技术 以 及 16.2 节 介绍 的 散 点 图 绘制 技术 ， 绘 
制 一 幅 散 点 图 来 展示 全 球 哪些 地 方 发 生 了 火灾 。 


16.3 ”小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 现实 世界 中 的 数据 集 ; 如 何 处 理 
CSV 和 JSON 文 件 ， 以 及 如 何 提 取 感 兴趣 的 数据 ， 如 何 使 用 
Matplotlib 来 处 理 以 往 的 天 气 数据 ， 包 括 如 何 使 用 模块 datetime 和 
如 何在 同一 个 图 表 中 绘制 多 个 数据 系列 ; 如 何 使 用 Plotly 绘 制 呈现 
地 质数 据 的 散 点 图 ; 以 及 如 何 设置 Plotly 散 点 图 和 图 表 的 样式 。 


有 了 使 用 CSV 和 JSON 文 件 的 经 验 后 ， 你 将 能 够 处 理 几 乎 任何 要 分 
析 的 数据 。 大 多 数 在 线 数据 集 能 以 这 两 种 格式 中 的 一 种 或 两 种 下 
载 。 熟 悉 了 这 两 种 格式 ， 再 学 习 使 用 其 他 格式 的 数据 就 会 更 简单 。 


在 下 一 章 ， 你 将 编写 目 动 从 网 上 采集 数据 并 对 其 进行 可 视 化 的 程 
序 。 如 果 你 只 是 将 编程 作为 业余 爱好 ， 学 会 这 些 技能 可 以 增加 乐 
趣 ， 如 果 你 有 志 于 成 为 专业 程序 员 ， 就 必须 掌握 这 些 技能 。 


半 ”使 用 API 


本 章 介 绍 如 何 编写 独立 的 程序 ， 对 获取 的 数据 进 
这 个 程序 将 使 用 Web 应 用 程序 编程 接口 〈API) 自 
动 请 求 网 站 的 特定 信息 而 不 是 整个 网 页 ， 再 对 这 些 信息 进行 可 
视 化 。 由 于 这 样 编写 的 程序 始终 使 用 最 新 的 数据 进行 可 视 化 ， 
即便 数据 瞬息 万 变 ， 它 呈现 的 信息 也 是 最 新 的 。 


17.1 使 用 Web API 


Web API 是 网 站 的 一 部 分 ， 用 于 与 使 用 具体 URL 请 求 特定 信息 的 程 
序 交 互 。 这 种 请 求 称 为 API 调 用 。 请 求 的 数据 将 以 易于 处 理 的 格式 
(如 JSON 或 CSV) 返回 。 依 赖 于 外 部 数据 源 的 大 多 数 应 用 程序 依 

赖 于 API 调 用 ， 如 集成 社交 媒体 网 站 的 应 用 程序 。 


17.1.1 _Git 和 GitHub 


本 章 的 可 视 化 基于 来 自 GitHub 的 信息 ， 这 是 一 个 让 程序 员 能 够 协作 
开发 项 目的 网 站 。 我 们 将 使 用 GitHub 的 API 来 请 求 有 关 该 网 站 中 
Python 项 目的 信息 ， 再 使 用 Plotly 生 成 交互 式 可 视 化 图 表 ， 呈 现 这 
些 项 目的 受 欢 迎 程度 。 


GitHub 的 名 字源 自 Git， 后 者 是 一 个 分 布 式 版 本 控制 系统 ， 帮 助人 
们 管理 为 项 目 所 做 的 工作 ， 避 免 一 个 人 所 做 的 修改 影响 其 他 人 所 做 
的 修改 。 在 项 目 中 实现 新 功能 时 ，Git 跟 踪 你 对 每 个 文件 所 做 的 修 
改 。 确 定 代 码 可 行 后 ， 你 提交 所 做 的 修改 ， 而 Git 将 记录 项 目 最 新 
的 状态 。 如 果 犯 了 错 ， 想 撤销 所 做 的 修改 ， 你 可 以 轻松 地 返回 到 以 
前 的 任何 可 行 状态 。 【要 更 深入 地 了 解 如 何 使 用 Git 进 行 版 本 控 

制 ， 请 参阅 附录 D。)〉 GitHub 上 的 项 目 都 存储 在 仓库 中 ， 后 者 包含 
与 项 目 相 关联 的 一 切 : 代码 、 项 目 参 与 者 的 信息 、 问 题 或 bug 报 


汗 、 A 与 
告 ， 等 等 。 


GitHub 用 户 可 以 给 喜欢 的 项 目 加 星 (star) 以 表示 支持 ， 还 可 以 跟 
踩 上 自己 可 能 想 使 用 的 项 目 。 在 本 章 中 ， 我 们 将 编写 一 个 程序 ， 目 动 
下 载 GitHub 上 星 级 最 高 的 Python 项 目的 信息 ， 并 对 这 些 信息 进行 可 
视 化 。 


17.1.2 ”使 用 API 调 用 请 求 数据 


GitHub 的 API 让 你 能 够 通过 API 调 用 来 请 求 各 种 信息 。 要 知道 API 调 
用 是 什么 样 的 ， 请 在 浏览 器 的 地 址 栏 中 输入 如 下 地 址 并 按 回 车 键 : 


https://api.github.com/search/repositories?q=language:python&sort=star 


[L | 


这 个 调用 返回 GitHub 当 前 托管 了 多 少 个 Python 项 目 ， 以 及 有 关 最 受 
欢迎 的 Python 仓 库 的 信息 。 下 面 来 仔细 研究 这 个 调用 。 开 头 的 
https://api.github.com/ 将 请 求 发 送 到 GitHub 网 站 中 响应 API 
调用 的 部 分 ， 接 下 来 的 search/repositories 让 API 搜 索 GitHub 
上 的 所 有 仓库 。 

repositories 后 面 的 问号 指出 需要 传递 一 个 实 参 。q 表示 查询 ， 
而 等 号 《= ) 让 我 们 能 够 开始 指定 查询 。 我 们 使 

用 language:python 指出 只 想 获 取 主 要 语言 为 Python 的 仓库 的 信 
居 。 最 后 的 &sort=stars 指定 将 项 目 按 星 级 排序 。 


下 面 显 示 了 啊 应 的 前 儿 行 。 


"total count": 3494012， 
"incomplete results": false, 
"items": [ 
{ 
"id": 21289116， 


"node_id": "MDEwO1Jl1cG9zaXRvcnkyMTI4OTEXxMA=="， 
"name": "awesome-python", 

"full name": "vinta/awesome-python", 

--Snip-- 


从 响应 可 知 ， 该 URL 并 不 适合 人 工 输入 ， 因 为 它 采 用 了 适合 程序 处 
理 的 格式 。 本 书 编写 期 间 ，GitHub 总 共有 3 494 012 个 Python 项 目 
( 见 @) 。 "incomplete_results'" 的 值 为 false ( 见 @) ， 由 
此 知道 请 求 是 成 功 的 〈 并 非 不 完整 的 ) 。 倘 若 GitHub 无 法 处 理 该 
API， 此 处 返回 的 值 将 为 true 。 接 下 来 的 列表 中 显示 了 返回 

的 "items"”， 其 中 包含 GitHub 上 最 受 欢 迎 的 Python 项 目的 详细 信息 
( 见 @) 。 


17.1.3 ”安装 Requests 


Requests 包 让 Python 程 序 能 够 轻松 地 同 网 站 请 求 信 息 并 检查 返回 的 
啊 应 。 要 安装 Requests， 可 使 用 pip : 


$ python -m pip install --user requests 


这 个 命令 让 Python 运行 模块 pip ， 并 在 当前 用 户 的 Python 安装 中 添 
加 Requests 包 。 如 果 你 运行 程序 或 安装 包 时 使 用 的 是 命令 python3 
或 其 他 命令 ， 请 务必 在 这 里 使 用 同样 的 命令 。 


注意 “如果 该 命令 在 macOS 系 统 上 不 管用 ， 可 以 尝试 删除 标 
志 --user 再 次 运行 。 


17.1.4 处理 API 响 应 


下 面 来 编写 一 个 程序 ， 它 目 动 执行 API 调 用 并 处 理 结果 ， 以 找 出 
GitHub 上 星 级 最 高 的 Python 项 目 : 


python repos.py 


@ import requests 


# 执行 API 调 用 并 存储 响应 。 
@ url = 'https://api.github.com/search/repositories?q=language:pythong& 
©@ headers = {'Accept': 'application/vnd.github.v3+json'} 
@ r= requests.get(url, headers=headers) 
@ print(f"Status code: {r.status code}") 


# 将 API 响 应 赋 给 一 个 变量 。 
@ response dict = r.json() 


t# 处 理 结果 o 
print(response dict.keys()) 


在 @ 处 ， 导 入 模块 requests 。 在 全 处， 存储 API 调 用 的 URL。 最 
新 的 GitHub API 版 本 为 第 3 版 ， 因 此 通过 指定 headers 显 式 地 要 求 
使 用 这 个 版 本 的 API( 见 @) ， 再 使 用 requests 调用 API【〈 见 
@).， 


我 们 调用 get() 并 将 URL 传 递 给 它 ， 再 将 响应 对 象 赋 给 变量 r 。 啊 
应 对 象 包 含 一 个 名 为 status_code 的 属性 ， 指 出 了 请 求 是 否 成 功 
(状态 码 200 表 示 请 求 成 功 ) 。 在 四处， 打印 status_code ， 核 实 


调用 是 否 成 功 。 


这 个 API 返 回 JSON 格 式 的 信息 ， 因 此 使 用 方法 json() 将 这 些 信 息 
转换 为 一 个 Python 字典 〈 见 @@) ， 并 将 结果 存储 在 response_dict 
中 


最 后 ， 打 印 response_dict 中 的 键 ， 输 出 如 下 : 


Status code: 266 
dict keys(['total count', 'incomplete results', "items ' ]) 


状态 码 为 200， 由 此 知道 请 求 成 功 了 。 啊 应 字典 只 包含 三 个 
键 : 'total_count' 、'incomplete results' 和 'items'。 下 
面 来 看 看 响应 字典 内 部 是 什么 样 的 。 


注意 ” 像 这 样 简 单 的 调用 应 该 会 返回 完整 的 结果 集 ， 因 此 完 
全 可 以 忽略 与 'ijncomplete_results' 关联 的 值 。 但 在 执行 
更 复杂 的 API 调 用 时 ， 应 检查 这 个 值 。 


17.1.5 ”人 处理 响应 字典 
将 API 调 用 返回 的 信息 存储 到 字典 后 ， 就 可 处 理 其 中 的 数据 了 。 我 


们 来 生成 一 些 概述 这 些 信 息 的 输出 。 这 是 一 种 不 错 的 方式 ， 可 确认 
收 到 了 期 望 的 信息 ， 进 而 开始 研究 感 兴趣 的 信息 : 


python_repos.py 


import requests 


# 执行 API 调 用 并 存储 响应 。 


--Snip-- 


# 将 API 啊 应 赋 给 一 个 变量 。 
response dict = r.json() 
@ print(f"Total repositories: {response dict['total count']}") 


# 探索 有 关 仓 库 的 信息 。 
@ repo dicts = response dict['items'] 
print(f"Repositories returned: {len(repo dicts)}") 


# 研究 第 一 个 仓库 。 
@ repo dict = repo dicts[6] 
@ print(f"\nKeys: {len(repo dict)}") 
@ for key in sorted(repo dict.keys()): 
print(key) 


在 @ 处 ， 打 印 与 'total _count' 相关 联 的 值 ， 它 指出 了 GitHub 总 
共 包 含 多 少 个 Python 仓库 。 


与 'items' 关联 的 值 是 个 列表 ， 其 中 包含 很 多 字典 ， 而 每 个 字典 都 
包含 有 关 一 个 Python 仓库 的 信息 。 在 四 处 ， 将 这 个 字典 列表 存储 
在 repo_dicts 中 。 接 下 来 ， 打 印 repo_dicts 的 长 度 ， 以 获悉 获 
得 了 多 少 个 仓库 的 信息 。 


为 更 深入 地 了 解 每 个 仓库 的 信息 ， 提 取 repo_dicts 中 的 第 一 个 字 
典 ， 并 将 其 存储 在 repo_dict 中 ( 见 @) 。 接 下 来 ， 打 印 这 个 字典 
包含 的 键 数 ， 看 看 其 中 有 多 少 信息 《〈 见 四 ) 。 在 加 处， 打印 这 个 字 
典 的 所 有 键 ， 看 看 其 中 包含 哪些 信息 。 


输出 让 我 们 对 实际 包含 的 数据 有 了 更 清晰 的 认识 : 


Status code: 266 
Total repositories: 34940630 
Repositories returned: 36 


Keys: 73 
archive url 
archived 


assignees url 
--Snip-- 

url 

watchers 
watchers count 


GitHub 的 API 返 回 有 关 仓 库 的 大 量 信息 : repo_dict 包含 73 个 键 
( 见 @) 。 通 过 仔细 查看 这 些 键 ， 可 大 致知 道 可 提取 有 关 项 目的 哪 
些 信 息 。 【要 准确 地 获悉 API 将 返回 哪些 信息 ， 要 么 阅读 文档 ， 要 


么 像 这 里 一 样 使 用 代码 来 查看 。 
下 面 来 提取 repo_dict 中 与 一 些 键 相关 联 的 值 : 


python_repos.py 


--Snip-- 

# 研究 有 关 仓 库 的 信息 。 

repo dicts = response dict['items'] 
print(f"Repositories returned: {len(repo dicts)}") 


# 研究 第 一 个 仓库 。 
repo dict = repo dicts[6] 


print("\nSelected information about first repository:") 
print(f"Name: {repo dict['name']}") 

print(f"Owner: {repo dict['owner']['login']}") 
print(f"Stars: {repo dict['stargazers count']}") 
print(f"Repository: {repo dict['html_ url']}") 
print(f"Created: {repo dict['created at']}") 
print(f"Updated: {repo dict['updated at']}") 
print(f"Description: {repo dict['description']}") 


这 里 打印 的 值 对 应 于 表示 第 一 个 仓库 的 字典 中 的 很 多 键 。 在 人 @ 处 ， 
打印 了 项 目的 名 称 。 项 目 所 有 者 是 由 -个 字典 表示 的 ， 因 此 @ 处 使 

用 键 owner 来 访问 表示 所 有 者 的 字典 ， 再 使 用 键 Kkey 来 获取 所 有 痢 
的 登录 名 。 在 全 处 ， 打 印 项 目 获得 了 多 少 个 星 的 评级 ， 以 及 该 项 目 
GitHub 仓 库 的 URL。 接 下 来 ， 显示 项 目的 创建 时 间 ( 见 @) 和 最 后 
一 次 更 新 的 时 间 ( 见 人 @)。 最 后 打印 仓库 的 描述 。 输 出 类 似 于 下 
这 样 : 


Status code: 266 
Total repositories: 3494632 
Repositories returned: 36 


Selected information about first repository: 

Name: awesome-python 

Owner: vinta 

Stars: 61549 

Repository: https://github.com/vinta/awesome-python 
Created: 2614-66-27T21:66:662 


Updated: 2619-62-17T64:3060:060Z 
Description: A curated list of awesome Python frameworks, libraries, s 
and resources 


从 上 述 输 出 可 知 ， 在 本 书 编写 期 间 ，GitHub 上 星 级 最 高 的 Python 项 
目 为 awesome-python， 其 所 有 者 为 用 户 vinta， 有 60 000 多 位 GitHub 

用 户 给 这 项 目 加 星 了 。 我 们 可 以 看 到 这 个 项 目 仓库 的 URL， 其 创建 
时 间 为 2014 年 6 月 ， 且 最 近 更 新 了 。 最 后 ， 描 述 指出 项 目 awesome- 

python 包 含 一 系列 深 受 欢迎 的 Python 资 源 。 


17.1.6 ”概述 最 受 欢 迎 的 仓库 
对 这 些 数据 进行 可 视 化 时 ， 我 们 想 洱 盖 多 个 仓库 。 下 面 就 来 编写 一 


个 循环 ， 打 印 API 调 用 返回 的 每 个 仓库 的 特定 信息 ， 以 便 能 够 在 可 
视 化 中 包含 所 有 这 些 信息 : 


python_repos.py 


--Snip-- 

# 研究 有 关 仓 库 的 信息 。 

repo dicts = response dict['items'] 
print(f"Repositories returned: {len(repo dicts)}") 


@ print("\nSelected information about each repository:") 
@ for repo dict in repo dicts: 


print(f"\nName: {repo dict['name']}") 
print(f"Owner: {repo dict['owner']['login']}") 
print(f"Stars: {repo dict['stargazers count']}") 
print(f"Repository: {repo dict['html url']}") 
print(f"Description: {repo dict['description']}") 


在 @ 处 ， 打 印 了 一 条 说 明 性 消息 。 在 人 处， 遍历 repo_dicts 中 的 
所 有 字典 。 在 这 个 循环 中 ， 打 印 每 个 项 目的 名 称 、 所 有 者 、 星 级 、 
在 GitHub 上 的 URL 以 及 描述 : 


Status code: 266 
Total repositories: 34946046 
Repositories returned: 36 


Selected information about each repository : 


Name: awesome-python 

Owner: vinta 

Stars: 61549 

Repository: https://github.com/vinta/awesome-python 

Description: A curated list of awesome Python frameworks, libraries, s 
and resources 


Name: system-design-primer 

Owner: donnemartin 

Stars: 57256 

Repository: https://github.com/donnemartin/system-design-primer 

Description: Learn how to design large-scale systems. Prep for the sys 
design interview. Includes Anki flashcards. 

--Snip-- 


Name: python-patterns 

Owner : faif 

Stars: 19658 

Repository: https://github.com/faif/python-patterns 
Description: A collection of design patterns/idioms in Python 


在 上 述 输出 中 ， 有 些 有 趣 的 项 目 可 能 值得 一 看 。 但 不 要 在 这 上 面 花 


费 太 多 时 间 ， 因 为 即将 创建 的 可 视 化 图 表 能 让 你 更 容易 地 看 清 结 
果 。 


17.1.7 ”监视 API 的 速率 限制 


大 多 数 API 存 在 速率 限制 ， 也 就 是 说 ， 在 特定 时 间 内 可 执行 的 请 求 
数 存在 限制 。 要 获悉 是 否 接近 了 GitHub 的 限制 ， 请 在 浏览 器 中 输入 
https://api.github.com/rate_limit， 你 将 看 到 类 似 于 下 面 的 啊 应 : 


{ 
"resources": { 
"core": { 
"limit": 60， 


"remaining": 58, 
"reset": 1556385312 
}, 


@ "search": { 


@ "limit": 10, 


日 "remaining": 8， 

@ "reset": 1556381772 
2 
--Snip-- 


我 们 关心 的 信息 是 搜索 API 的 速率 限制 ( 见 @) 。 从 四 处 可 知 ， 极 
限 为 每 分 钟 10 个 请 求 ， 而 在 当前 分 钟 内 ， 还 可 执行 8 个 请 求 〈 见 
合 ) 。reset 值 指 的 是 配额 将 重 置 的 Unix 时 间 或 新 纪元 时 间 


《1970 年 1 月 1 日 午夜 后 多 少 秒 ) ( 见 @) 。 用 完 配 额 后 ， 你 将 收 到 
一 条 简单 的 响应 ， 由 此 知道 已 到 达 API 极 限 。 到 达 极 限 后 ， 必 须 等 
待 配额 重 置 。 


注意 “很 多 API 要 求 注册 获得 API 密 钥 后 才能 执行 API 调 用 。 本 
书 编写 期 间 ，GitHub 没 有 这 样 的 要 求 ， 但 获得 API 密 钥 后 ， 配 
额 将 高 得 多 。 


17.2 ”使 用 Plotly 可 视 化 仓库 


有 了 一 些 有 趣 的 数据 后 ， 我 们 来 进行 可 视 化 ， 呈 现 GitHub 上 Python 

项 目的 受 欢迎 程度 。 我 们 将 创建 一 个 交互 式 条 形 图 : 条 形 的 高 度 表 

示 项 目 获 得 了 多 少 颗 星 。 单 击 条 形 将 市 你 进入 项 目 在 GitHub 上 的 主 

的 ， 并 将 副本 修改 成 下 
这 样 : 


python_repos_visual.py 


import requests 
from plotly.graph _ objs import Bar 
from plotly import offline 


# 执行 API 调 用 并 存储 响应 。 

url = "https://api.github.com/search/repositories?q=language:pythong& 
headers = {'Accept': 'application/vnd.github.v3+json'} 

r = requests.get(url, headers=headers) 

print(f"Status code: {r.status code}") 


# 处 理 结果 。 

response dict = r.json() 

repo dicts = response dict['items'] 

repo_names, stars = []，[] 

for repo dict in repo dicts: 
repo_names.append(repo dict[ ' name ']) 
stars.append(repo_dict[ "stargazers_count '] ) 


# 可 视 化 。 

data = [{ 
'type': 'bar', 
'x': repo_names, 
'y': stars, 

}] 

my_layout = { 
'title': 'GitHub 上 最 受 欢迎 的 python 项 目 ' 
"xaxis': {'title': 'Repository'}, 
'yaxis': {'title': 'Stars'}, 


} 


fig = {'data': data, 'layout': my_layout} 
offline.plot(fig, filename='python repos.html') 


[L | 


在 @@ 处 ， 导 入 Plotly 中 的 Bar 类 和 模块 offline 。 像 第 15 章 的 绘制 
直方 图 项 目 中 定义 列表 data 那样 ， 这 里 也 使 用 字典 来 定义 布局 ， 

因此 不 需要 导入 Layout 类 。 这 里 也 打印 API 啊 应 的 状态 ， 以 便 知道 
是 否 出 现 了 问题 ( 见 @) 。 现 在 不 是 探索 阶段 ， 早 已 确定 了 所 需 的 
数据 是 存在 的 ， 因 此 删除 部 分 处 理 API 啊 应 的 代码 。 


接 下 来 ， 创 建 两 个 空 列表 ， 用 于 存储 要 在 图 表 中 呈现 的 数据 ( 见 
人 全) .我 们 需要 每 个 项 目的 名 称 ， 用 于 给 条 形 添加 标签 ， 还 需要 知 
道 项 目 获得 了 多 少 个 星 ， 用 于 指定 条 形 的 高 度 。 在 循环 中 ， 将 每 个 
项 目的 名 称 和 星 级 分 别 附 加 到 这 两 个 列表 末尾 。 


然后 ， 定 义 列表 data ( 见 @) 。 它 像 第 16 章 的 列表 data 一 样 包含 
一 个 字典 ， 指 定 了 图 表 的 类 型 ， 并 提供 了 z 值 和 y 值 ，z 值 为 项 目 名 
称 ，y 值 为 项 目 获 得 了 多 少 个 星 。 


在 全 处 ， 使 用 字典 定义 图 表 的 布局 。 这 里 没有 创建 Layout 实例 ， 
而 是 创建 了 一 个 包含 布局 规范 的 字典 ， 并 在 其 中 指定 了 图 表 的 名 称 
以 及 每 个 坐标 轴 的 标签 。 


生成 的 图 表 如 图 17-1 所 示 。 从 中 可 知 ， 前 几 个 项 目的 受 欢 迎 程度 比 
其 他 项 目 高 得 多 ， 但 所 有 这 些 项 目 在 Python 生态 系统 中 都 很 重要 。 
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图 17-1 _GitHub 上 最 受 欢 迎 的 Python 项 目 
17.2.1 ”改进 Plotly 图 表 


下 面 来 改进 这 个 图 表 的 样式 。 第 16 间 介绍 过 ， 可 在 data 和 
my_layout 中 以 键 值 对 的 形式 指 2 


通过 修改 data ， 可 定制 条 形 。 下 面 是 修改 后 的 data ， 给 条 形 指 
了 颜色 和 边框 : 


python_repos_visual.py 


--Snip-- 
data = [{ 
‘type': "bar ， 
'x': repo_names, 
'y': stars, 
"marker': { 
'color': 'rgb(606, 160, 150)',， 


"line': {'width': 1.5, 'color': 'rgb(25, 25, 25)'} 
}， 
'opacity': 6.6， 
}] 


--Snip-- 


marker 设置 影响 条 形 设计 。 我 们 给 条 形 指 定 了 一 种 自 定义 的 赣 
色 ， 加 上 了 宽 1.5 像 素 的 深 灰 色 轮 廓 ， 还 将 条 形 的 不 透明 度 设 置 为 
0.6， 以 免 图 表 过 于 惹眼 。 


下 面 来 修改 my_layout : 


python_repos_visual.py 


--Snip-- 
my_layout = { 
'title': 'GitHub 上 最 受 欢迎 的 Python 项 目 '， 
@ 'titlefont': {'size': 28}, 
@ 'xaxis': { 
'title': 'Repository', 
'titlefont': {'size': 24}, 


'tickfont': {'size': 14}, 


}, 
© "yaxis': { 
'title': 'Stars', 
'titlefont': {'size': 24}, 
'tickfont': {'size': 14}, 
}, 
} . 
--Snip-- 


使 用 键 'titlefont' 指定 图 表 名 称 的 字号 〈( 见 @) 。 在 字 

典 'xaxis' 中 ， 添 加 指定 z 轴 标 签字 号 的 设置 ('titlefont' ) 和 
刻度 标签 字号 的 设置 ('tickfont' ) ( 见 人 @) 。 由 于 这 些 设置 租 
套 在 字典 中 ， 还 可 以 使 用 相应 的 键 指 定 坐 标 轴 标 签 和 刻度 标签 的 其 
色 和 字体 。 在 命 处， 给 y 轴 指 定 类 似 的 设置 。 


重新 设置 样式 后 的 图 表 如 图 17-2 所 示 。 
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图 17-2 ”改进 了 图 表 的 样式 


one Peog ee i Shen 的 django 
oe 


& 
of 
or 


he em。 SNe, Soi bdo, Ser hs Hh Ce oO HK Ose、 90、。 0 人 
hoe Sos coy Cres soe i og, rome Mer bor on ng so Soo me a 


17.2.2 添加 自 定义 工具 提示 


在 Plotly 中 ， 将 姐 标 指 问 条 形 将 显示 其 表示 的 信息 。 这 通 第 称 为 工 
具 提 示 。 在 本 例 中 ， 当 前 显示 的 是 项 目 获 得 了 多 少 个 星 。 下 面 来 


创建 目 定 义工 具 提 示 ， 以 显示 项 目的 描述 和 所 有 者 。 
为 生成 这 样 的 工具 提示 ， 需 要 再 提取 一 些 信息 并 修改 对 象 data : 


python_repos_visual.py 


--Snip-- 

# 处 理 结 果 。 

response dict = r.json() 

repo dicts = response dict['items'] 

repo_names, stars, labels = [], [], [] 

for repo dict in repo dicts: 
repo_names.append(repo dict[ ' name ']) 
stars.append(repo dict['stargazers count']) 


owner = repo dict['owner']['login’'] 
description = repo dict['description'] 
label = f"{owner}<br />{description}" 
labels.append(label) 


# 可 视 化 。 
data = [{ 
'type': 'bar', 
'x': repo_names， 
'y': stars, 
'hovertext': labels, 
"marker': { 
'color': "rgb(66，166，156) ， 
"line': {'width': 1.5, 'color': 'rgb(25, 25, 25)'} 
}, 
'opacity': 6.6, 
}] 


--Snip-- 


首先 新 建 一 个 空 列表 1abe1ls ， 用 于 存储 要 给 各 个 项 目 显 示 的 文本 
( 见 @) 。 在 处 理 数据 的 循环 中 ， 提 取 每 个 项 目的 所 有 者 和 描述 

( 见 人 @) 。Plotly 人 允许 在 文本 元 素 中 使 用 HTML 人 代码， 因此 在 创建 
由 项 目 所 有 者 和 描述 组 成 的 字符 串 时 ， 我 们 能 够 在 这 两 部 分 之 间 添 
加 换行 符 (<br /> ) ( 见 人 人 @) 。 人 然后 ， 将 这 个 字符 串 附 加 到 列 
表 1labels 末尾 。 


在 列表 data 包含 的 字典 中 ,添加 了 键 'hovertext' ， 并 将 与 之 关 


联 的 值 指定 为 刚 创建 的 列表 ( 见 @) 。Plotly 创 建 每 个 条 形 时 ， 将 
提取 这 个 列表 中 的 文本 ， 并 在 观察 者 将 鼠标 指向 条 形 时 显示 。 这 样 
修改 后 ， 生 成 的 图 表 如 图 17-3 所 示 。 
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图 17-3 ”将 鼠标 指 加 条 形 时 ， 将 显示 项 目的 描述 和 所 有 者 


17.2.3 ”在 图 表 中 添加 可 单 击 的 链接 

Plotly 人 允许 在 文本 元 素 中 使 用 HTML， 让 你 能 够 轻松 地 在 图 表 中 添 
加 链接 。 下 面 将 z 轴 标 签 作为 链接 ， 让 观察 者 能 够 访问 项 目 在 
GitHub 上 的 主页 。 为 此 ， 需 要 提取 URL 并 用 其 生成 zx 轴 标 签 : 


python_repos_visual.py 


--Snip-- 
# 处 理 结 
response dict = r.json() 
repo dicts = response dict['items'] 
@ repo_ links, stars, labels = [], [], [] 
for repo dict in repo dicts: 
repo_name = repo dict['name'] 
@ repo_url = repo dict['html _ url'] 
© repo_link = f"<a href='{repo_url}'>{repo_ name}</a>" 
repo_links.append(repo_ link) 


stars.append(repo dict['stargazers count']) 
--Snip-- 


# 可 视 化 。 
data = [{ 
'type': 'bar', 
@ 'x': repo_links, 
'y': stars, 
--Snip-- 
}] 


--Snip-- 


这 里 修改 了 列表 的 名 称 〈 从 repo_names 改 为 repo_links ) ， 更 
准确 地 指出 了 要 组 合 的 信息 ( 见 @) 。 接 下 来 ， 从 repo_dict 中 提 


取 项 目的 URL， 并 将 其 赋 给 临 时 变量 repo_url ( 见 @) . 在 @ 
处 ， 创 建 一 个 指 问 项 目的 链接 ， 为 此 使 用 了 HTML 标 记 <a> ， 其 格 
式 为 <a href='URL'>link text</a> 。 然 后 ， 将 这 个 链接 附加 到 
列表 repo_links 末尾 。 


在 @@ 处 ， 将 这 个 列表 用 作 图 表 的 z 值 。 生 成 的 图 表 与 前 面相 同 ， 但 
观察 者 可 单 击 图 表 底 端的 项 目 名 ， 以 访问 项 目 在 GitHub 上 的 主页 。 
它 是 交互 性 
J， 包含 丰富 的 信息 ! 


17.2.4 ”深入 了 解 Plotly 和 GitHub API 


要 深入 地 了 解 如 何 生 成 Plotly 图 表 ， 有 两 个 不 错 的 地 方 可 以 查看 。 
第 一 个 是 Plotly User Guide in Python。 通 过 研究 该 资源 ， 可 更 深入 
地 了 解 Plotly 是 如 何 使 用 数据 来 生成 可 视 化 图 表 的 ， 以 及 它 末 取 这 
种 做 法 的 原因 。 


第 二 个 不 错 的 资源 是 Plotly 网 站 中 的 Python Figure Reference， 其 中 
列 出 了 可 用 来 配置 Plotly 可 视 化 的 所 有 设置 。 这 里 还 列 出 了 所 有 的 
图 表 类 型 ， 以 及 在 各 个 配置 选项 中 可 设置 的 属性 。 


要 更 深入 地 了 解 GitHub API， 可 参阅 其 文档 。 通 过 阅读 文档 ， 你 可 
以 知道 如 何 从 GitHub 提 取 各 种 信息 。 如 果 有 GitHub 账 户 ， 六 
众 提供 的 有 关 仓 库 的 信息 外 ， 你 :还 可 以 提取 有 关上 自己 的 信息 


17.3 Hacker News API 


为 探索 如 何 使 用 其 他 网 站 的 API 调 用 ， 我 们 来 看 看 Hacker News。 在 
Hacker News 网 站 ， 用 户 分 享 编程 和 技术 方面 的 文章 ， 并 就 这 些 文 
章 展开 积极 的 讨论 。Hacker News 的 API 证 你 能 够 访问 有 关 该 网 站 所 
有 文章 和 评论 的 信息 ， 且 不 要 求 通过 注册 获得 密 铀 。 


下 面 的 调用 返回 本 书 编写 期 间 最 热门 的 文革 的 信息 : 


https://hacker-news.firebaseio.com/ve/item/19155826.json 


如 果 在 浏览 器 中 输入 这 个 URL， 将 发 现 啊 应 位 于 一 对 花 括号 内 ， 表 
明 这 古 一 个 子 内 如 果 不 改进 格式 ， 这 样 的 响应 难以 阅读 。 下 面 像 

第 16 章 的 地 震 地 图 项 目 那样 ， 通过 方法 json .dump() 来 运行 这 个 
URL， 以 便 对 返回 的 信息 进行 探索 : 


hn_article.py 


import requests 
import json 


# 执行 API 调 用 并 存储 响应 。 

url = 'https://hacker-news.firebaseio.com/v8e/item/19155826.json' 
r = requests.get(url) 

print(f"Status code: {r.status code}") 


# 探索 数据 的 结构 。 

response dict = r.json() 

readable file = 'data/readable_ hn data.json’ 

with open(readable file, 'w') as f: 
json.dump(response dict, f, indent=4) 


OT 你 应 该 不 会 感到 陌生 。 输 出 是 
一 个 字典 ， 其 中 包含 有 关 ID 为 19155826 的 文章 的 信息 : 


readable_hn_data.json 


"by": "jimktrains2", 
"descendants": 220， 
"id": 19155826， 
"kids": [ 
19156572， 
19158857， 
--Snip-- 


"time": 15560085414， 

"title": "Nasa's Mars Rover Opportunity Concludes a 15-Year Miss 
"type": "story", 

"url": "https://www.nytimes.com/.../mars-opportunity-rover-dead. 


这 个 字典 包含 很 多 键 。 与 键 'descendants' 相关 联 的 值 是 文章 被 
评论 的 次 数 ( 见 @) 。 与 键 'kids' 相关 联 的 值 包含 文章 所 有 评论 
的 ID ( 见 @) 。 每 个 评论 本 身 也 可 能 有 评论 ， 因 此 文章 的 后 代 
(Cdescendant) 数量 可 能 比 其 "kids' 的 数量 多 。 这 个 字典 中 还 包含 
当前 文章 的 标题 ( 见 @) 和 URL ( 见 @) 。 


下 面 的 URL 返 回 一 个 列表 ， 其 中 包含 Hacker News 上 当前 排名 靠 前 
的 文章 的 ID: 


https://hacker-news.firebaseio.com/ve/topstories.json 


通过 使 用 这 个 调用 ， 可 获悉 当前 有 哪些 文章 位 于 主页 ， 再 生成 一 系 
列 类 似 于 前 面 的 API 调 用 。 通 过 使 用 这 种 方法 ， 可 概述 当前 位 于 
Hacker News 主 页 的 每 篇 文章 : 


hn_submissions.py 


from operator import itemgetter 


import requests 


# 执行 API 调 用 并 存储 响应 。 

url = 'https://hacker-news.firebaseio.com/ve/topstories.json' 
r = requests.get(url) 

print(f"Status code: {r.status code}") 


# 处 理 有 关 每 篇 文章 的 信息 。 
submission ids = r.json() 
submission dicts = [] 
for submission id in submission ids[:36] : 
# 对 于 每 篇 文章 ， 都 执行 一 个 API 调 用 。 
url = f"https://hacker-news.firebaseio.com/ve/item/{submission i 
r = requests.get(url) 
print(f"id: {submission id}\tstatus: {r.status code}") 
response dict = r.json() 


# 对 于 每 篇 文章 ， 都 创建 一 个 字典 。 
submission dict = { 
'title': response dict['title'], 
'hn_link': f"http://news.ycombinator.com/item?id={submission 
'comments': response dict['descendants'|],， 


} 


© submission dicts.append(submission dict) 


@ submission dicts = sorted(submission dicts, key=itemgetter('comments 
reverse=True) 


@ for submission dict in submission dicts: 
print(f"\nTitle: {submission dict['title']}") 
print(f"Discussion link: {submission dict['hn link']}") 
print(f"Comments: {submission dict['comments']}") 


首先 ， 执 行 一 个 API 调 用 ， 并 打印 响应 的 状态 〈 见 @@) 。 这 个 API 

调用 返回 一 个 列表 ， 其 中 包含 Hacker News 上 当前 最 热门 的 500 篇 文 
章 的 ID 。 接 下 来 ， 将 响应 对 象 转换 为 一 个 Python 列表 〈 见 多 ) ， 并 
将 其 存储 在 submission ids 中 。 后 面 将 使 用 这 些 ID 来 创建 一 系列 
字典 ， 其 中 每 个 字典 都 存储 了 一 篇 文章 的 信息 。 


在 全 处 ， 创 建 一 个 名 为 submission_dicts 的 空 列表 ， 用 于 存储 前 
面 所 说 的 字典 。 接 下 来 ， 遍 历 前 30 篇 文章 的 ID。 对 于 每 篇 文章 ， 都 
执行 一 个 API 调 用 ， 其 中 的 URL 包 含 submission id 的 当前 值 〈 见 
四 ) 。 我 们 打印 请 求 的 状态 和 文章 ID， 以 便 知道 请 求 是 否 成 功 。 


在 加 处 ， 为 当前 处 理 的 文章 创建 一 个 字典 ， 并 在 其 中 存储 文章 的 标 
题 、 讨 论 页面 的 链接 和 评论 数 。 然 后 ， 将 submission_dict 附加 
到 submission dicts 末尾 ( 风 @) 。 


Hacker News 上 的 文章 是 根据 总 体 得 分 排名 的 ， 而 总 体 得 分 取决 于 

很 多 因素 ， 包 含 被 推荐 的 次 数 、 评 论 数 和 发 表 时 间 。 我 们 要 根据 评 
论 数 对 字典 列表 submission_ dicts 进行 排序 ， 为 此 使 用 了 模 

块 operator 中 的 函数 itemgetter() ( 见 @) 。 我 们 向 这 个 函数 

传递 了 键 'comments' ， 因 此 它 从 该 列表 的 每 个 字典 中 提取 与 

键 'comments' 关联 的 值 。 这 样 ， 函 数 sorted() 将 根据 这 个 值 对 

人 我 们 将 列表 按 降 序 排列 ， 即 评论 最 多 的 文章 位 于 最 
HY EH] 。 


对 列表 排序 后 遍历 它 《〈 见 候 ) ， 并 打印 每 篇 热门 文章 的 三 项 信息 : 
标题 、 讨 论 页 面 的 链接 和 评论 数 : 


Status code: 2600 

id: 19155826 status: 
id: 19186181 status: 
id: 19181473 status: 
--Snip-- 


Title: Nasa's Mars Rover Opportunity Concludes a 15-Year Mission 
Discussion link: http://news.ycombinator.com/item?id=19155826 
Comments: 226 


Title: Ask HN: Is it practical to create a software-controlled model r 
Discussion link: http://news.ycombinator.com/item?id=19186181 
Comments: 72 


Title: Making My Own USB Keyboard from Scratch 

Discussion link: http://news.ycombinator.com/item?id=19181473 
Comments: 62 

--Snip-- 


无 论 使 用 哪个 API 来 访问 和 分 析 信 息 ， 流 程 都 与 此 类 似 。 有 了 这 些 
数据 后 ， 束 可 进行 可 视 化 ， 指 出 最 近 哪 些 文章 引发 了 最 激烈 的 讨 
论 。 基 于 这 种 方式 ， 应 用 程序 可 以 为 用 户 提 供 网 站 (如 Hacker 

News) 的 定制 化 阅读 体验 。 要 深入 了 解 通 过 Hacker News API 可 访 


问 哪些 信息 ， 请 参阅 其 文档 页 面 。 
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练习 17-1: 其 他 语言 ”修改 python_repos.py 中 的 API 调 用 ， 使 


其 在 生成 的 图 表 中 显示 其 他 语言 最 受 欢迎 的 项 目 。 请 尝试 语言 
JavaScript、Ruby、C、Java、Perl、Haskell 和 Go。 


练习 17-2: 最 活跃 的 讨论 使 用 hn_submissions.py 中 的 数据 ， 

创建 一 个 条 形 图 ， 显 示 Hacker News 上 当前 最 活跃 的 讨论 。 条 

形 的 高 度 应 对 应 于 文章 的 评论 数 。 条 形 的 标签 应 包含 文章 的 标 
题 ， 并 且 充 当 到 文章 讨论 页 面 的 链接 。 


练习 17-3: 测试 python_repos.py 在 python_repos.py 中 ， 我 们 
打印 了 status_code 的 值 ， 以 核实 API 调 用 是 否 成 功 。 请 编写 
一 个 名 为 test_python_repos.py 的 程序 ， 它 使 用 单元 测试 来 断 
言 status_code 的 值 为 200。 想 想 还 可 做 出 哪些 断言 ， 如 返回 
的 条 目 (item) 数 符合 预期 ， 仓 库 总 数 超 过 特定 的 值 ， 等 等 。 


练习 17-4: 进一步 探索 ”查看 Plotly 以 及 GitHub API 或 Hacker 
News API 的 文档 ， 再 根据 从 中 获得 的 信息 来 定制 本 节 绘 制 的 图 
表 的 样式 ， 或 者 提取 并 可 视 化 其 他 数据 。 


17.4 ”小 结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 API 来 编写 独立 的 程序 ， 以 自动 采 
集 所 需 的 数据 并 对 其 进行 可 视 化 ; 使 用 GitHub API 来 探索 GitHub 上 
星 级 最 高 的 Python 项 目 ， 还 大 致 地 了 解 了 Hacker News API; 如 何 使 
用 Requests 包 来 自动 执行 GitHub API 调 用 ， 以 及 如 何 处 理 调用 的 结 

果 。 本 章 还 简要 介绍 了 一 些 Plotly 设 置 ， 可 用 其 进一步 定制 生成 的 

图 表 的 外 观 。 


0 目 中 ， 我 们 将 使 用 Django 来 创建 一 个 web 应 用 
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项 目 3 Web 应 用 程序 


第 18 章 从 Django 入 于 


2 在 幕后 ， 当 今 的 网 站 实际 上 都 是 语 应 用 程序 (rich 
application ) ， 就 像 成 熟 的 昌 面 应 用 程序 一 样 。Python 提 供 了 
一 组 开发 Web 应 用 程序 的 早 越 工具 。Django 是 一 个 Web 框 架 ， 
即 一 套 旨 在 帮助 开发 交互 式 网 站 的 工具 。 本 章 将 介绍 如 何 使 用 
Django 来 开发 一 个 名 为 “学 习 笔 记 ” 的 项 目 ， 这 是 一 个 在 线 日 志 
系统 ， 让 你 能 够 记录 学 习 到 的 有 关 特 定 主题 的 知识 。 


我 们 将 为 这 个 项 目 制定 规范 ， 然 后 为 应 用 程序 使 用 的 数据 定义 模 
型 。 我 们 将 使 用 Django 的 管理 系统 来 输入 一 些 初 始 数据 ， 再 学 习 编 
写 视 图 和 模板 ， 让 Django 能 够 为 我 们 的 网 站 创建 页 面 。 


Django 能 够 啊 应 页 面 请 求 ， 还 让 你 能 够 更 轻松 地 读 写 数据 库 、 管 理 
用 户 ， 等 等 。 第 19 草 和 第 20 章 将 改进 “学 习 笔 记 ” 项 目 ， 再 将 其 部 普 
到 活动 的 服务 器 ， 让 你 和 朋友 都 能 够 使 用 它 。 


18.1 建立 项 目 


建立 项 目 时 ， 首 先 需 要 以 规范 的 方式 对 项 目 进行 描述 ， 再 建立 虚拟 
环境 ， 以 便 在 其 中 创建 项 目 。 


18.1.1 制定 规范 


完整 的 规范 详细 说 明了 项 目的 目标 ， 阐 述 了 项 目的 功能 ， 并 讨论 了 
项 目的 外 观 和 用 户 界 面 。 与 任何 民 好 的 项 目 规划 和 商业 计划 书 一 
样 ， 规 范 应 突出 重点 ， 帮 助 避免 项 目 仿 离 轨道 。 这 里 不 会 制定 完整 
的 项 目 规 划 ， 只 列 出 一 些 明 确 的 目标 ， 以 突出 开发 的 重点 。 我 们 制 
定 的 规范 如 下 : 


我 们 要 编写 一 个 名 为 “学 习 笔记 ”的 Web 应 用 程序 ， 让 用 户 能够 
记录 感 兴趣 的 主题 ， 并 在 学 习 每 个 主题 的 过 程 中 添加 日 志 条 
目 .“ 学 习 笔 记 ” 的 主页 对 这 个 网 站 进行 描述 ， 并 邀请 用 户 注册 
或 登录 。 用 户 登 录 后 ， 可 以 创建 新 主题 、 添 加 新 条 目 以 及 阅读 
既 有 的 条 目 。 


学 习 新 的 主题 时 ， 记 录 学 到 的 知识 可 帮助 跟踪 和 复习 这 些 知 识 。 优 
秀 的 应 用 程序 让 这 个 记录 过 程 简单 易 行 。 

18.1.2 ”建立 虚拟 环境 

要 使 用 Django， 首 先 需要 建立 一 个 虚拟 工作 环境 。 虚 拟 环境 是 系 
统 的 一 个 位 置 ， 可 在 其 中 安装 包 ， 并 将 之 与 其 他 Python 包 隔 离 。 将 
项 目的 库 与 其 他 项 目 分 离 是 有 益 的 ， 并 且 为 了 在 第 20 章 将 “学 习 笔 
记 ” 部 署 到 服务 器 ， 这 也 是 必需 的 。 


为 项 目 新 建 一 个 日 录 ， 将 其 命名 为 learning_log， 再 在 终端 中 切换 到 
这 个 目录 ， 并 执行 如 下 命令 创建 一 个 虚拟 环境 : 


learning log$ python -m venv 11_env 
learning log$ 


这 里 运行 了 模块 venv ， 并 使 用 它 创 建 了 一 个 名 为 ]_env 的 虚拟 环 
境 。《 请 注意 ，1L_env 的 开头 是 两 个 小 写字 母 1， 而 不 是 数字 1。 ) 
如 果 你 运行 程序 或 安装 包 时 使 用 的 是 命令 python3 ， 这 里 也 务必 
使 用 同样 的 命令 。 


18.1.3 ”激活 虚拟 环境 
现在 需要 使 用 下 面 的 命令 激活 虚拟 环境 : 


learning log$ source 11 env/bin/activate 
@ (ll] env)learning log$ 


这 个 命令 运行 1〗 enwbin 中 的 脚本 activate。 环 境 处 于 活动 状态 时 ， 环 
境 名 将 包含 在 圆 括 号 内 ， 如 人 @ 处 所 示 。 在 这 种 情况 下 ， 你 可 以 在 环 
境 中 安装 包 ， 并 使 用 已 安装 的 包 。 在 1]L_env 中 安装 的 包 仅 在 该 环境 
处 于 活动 状态 时 才 可 用 。 


注意 ”如 果 你 使 用 的 是 Windows 系 统 ， 请 使 用 命令 
11_env\Scripts\activate (不 包含 source ) 来 激活 这 个 
虚拟 环境 。 如 果 你 使 用 的 是 PowerShell， 可 能 需要 将 Activate 
的 首 字 母 大 写 。 


要 停止 使 用 虚拟 环境 ， 可 执行 命令 deactivate : 


(11_env)learning log$ deactivate 
learning log$ 


如 果 关 闭 运行 虚拟 环境 的 终端 ， 虚 拟 环境 也 将 不 再 处 于 活动 状态 。 
18.1.4 安装 Django 
激活 虚拟 环境 后 ， 执 行 如 下 命令 安装 Django: 


(11_env)learning log$ pip install django 
Collecting django 


--Snip-- 

Installing collected packages: pytz, django 

Successfully installed django-2.2.6 pytz-2618.9 sqlparse-0.2.4 
(11_env)learning log$ 


由 于 是 在 虚拟 环境 (独立 的 环境 ) 中 工作 ， 在 各 种 系统 中 安装 
Django 的 命令 都 相同 : 不 需要 指定 标志 --user ， 也 不 需要 使 用 像 
python -m pip install package_name 这 样 较 长 的 命令 。 


别 筷 了 ，Django 仅 在 虚拟 环境 1_env 处 于 活动 状态 时 才 可 用 。 


注意 “每 隔 大 约 8 个 月 ，Django 新 版 本 束 会 发 布 ， 因 此 在 你 安 
装 Django 时 ， 看 到 的 可 能 是 更 新 的 版 本 。 即 便 你 使 用 的 是 更 新 
的 Django 版 本 ， 这 个 项 目 也 可 行 。 如 果 要 使 用 这 里 所 示 的 
Django 版 本 ， 请 使 用 命令 pip install django==2.2.* 安装 
Django 2.2 的 最 新 版 本 。 如 果 你 在 使 用 更 新 的 版 本 时 过 到 研 
烦 ， 请 参阅 本 书 的 在 线 配套 资源 。 


18.1.5 ”在 Django 中 创建 项 目 


在 虚拟 环境 依然 处 于 活动 状态 的 情况 下 〈lLenv 包 含 在 圆 括号 
内 ) ， 执 行 如 下 命令 新 建 一 个 项 目 : 


@ (ll1 env)learning log$ django-admin startproject learning log . 
@ (ll1 env)learning log$ 1s 
learning log 11] env manage.py 


©@ (ll1 env)learning log$ ls learning log 
_ init .py settings.py urls.py wsgi.py 


@ 处 的 命令 让 Django 新 建 一 个 名 为 learning_log 的 项 目 。 这 个 命令 末 
尾 的 句点 让 新 项 目 使 用 合适 的 目录 结构 ， 这 样 开 发 完成 后 可 轻松 地 
将 应 用 程序 部 署 到 服务 器 。 


注意 “和 王 万 别 筷 了 这 个 句点 ， 否 则 部 车 应 用 程序 时 将 章 遇 一 
些 配置 问题 。 如 果 瑟 记 了 这 个 句点 ， 要 删除 已 创建 的 文件 和 文 
件 夹 〈lLenv 除 外 ) ， 再 重新 运行 这 个 命令 。 


在 信人 处， 运行 命令 ls (在 Windows 系 统 上 为 dir ) ， 结 果 表 明 

Django 新 建 了 一 个 名 为 learning_log 的 目录 ， 还 创建 了 文件 

manage.py。 后 者 是 一 个 简单 的 程序 ， 接 受命 令 并 将 其 交 给 Django 

我 们 将 使 用 这 些 命令 来 管理 使 用 数据 库 和 运行 服 
等 任 , 


目录 learning_log 包 含 4 个 文件 ( 见 人 @) ， 最 重要 的 是 settings.py、 
urls.py 和 wsgi.py。 文 件 settings.py 指 定 Django 如 何 与 系统 交互 以 及 如 
何 管理 项 目 。 在 开发 项 目的 过 程 中 ， 我 们 将 修改 其 中 一 些 设置 ， 并 
添加 一 些 设置 。 文 件 urls.py 告 诉 Django， 应 创建 哪些 页 面 来 响应 浏 
史 嚣 请求。 文件 wsgi.py 帮 助 Django 提 供 它 创建 的 文件 ， 这 个 文件 名 
是 Web 服 务 器 网 关 接 口 (Web server gateway interface ) 的 首 字母 
缩写 。 


18.1.6 ”创建 数据 库 
Django 将 大 部 分 与 项 目 相关 的 信息 存储 在 数据 库 中 ， 因 此 需要 创建 


一 个 供 Django 使 用 的 数据 库 。 为 给 项 目 “ 学 习 笔记 ?创建 数据 库 ， 请 
在 虚拟 环境 处 于 活动 状态 的 情况 下 执行 下 面 的 命令 : 


(11_env)learning log$ python manage.py migrate 
@ Operations to perform : 
Apply all migrations: admin, auth, contenttypes, sessions 
Running migrations : 
Applying contenttypes.6681 initial... OK 
Applying auth.6661 initial... OK 


--Snip-- 
Applying sessions.6661 initial... OK 
@ (ll env)learning log$ 1s 
db.sqlite3 learning log 1l1 env manage.py 


我 们 将 修改 数据 库 称 为 迁移 (migrate 数据 库 。 首 次 执行 命令 
migrate 时 ， 将 让 Django 确 保 数 据 库 与 项 目的 当前 状态 匹配 。 在 使 
用 SQLite (后 面 将 详细 介绍 〉 的 新 项 目 中 首次 执行 这 个 命令 时 ， 
Django 将 新 建 一 个 数据 库 。 在 @ 处 ，Django 指 出 它 将 准备 好 数据 
库 ， 用 于 存储 执行 管理 和 身份 验证 任务 所 需 的 信息 。 


在 全 处 运行 命令 ls ， 其 输出 表明 Django 又 创建 了 一 个 文件 


db.sqlite3。SQLite 是 一 种 使 用 单个 文件 的 数据 库 ， 是 编写 简单 应 用 
程序 的 理想 选择 ， 因 为 它 让 你 不 用 太 关 注 数据 库 管理 的 问题 。 


注意 ”在 虚拟 环境 中 运行 manage.py 时 ， 务 必 使 用 命令 python 
， 即 便 你 在 运行 其 他 程序 时 使 用 的 是 男 外 的 命令 ， 如 python3 
。 在 虚拟 环境 中 ， 命 令 python 指 的 是 在 虚拟 环境 中 安装 的 
Python 版 本 。 


18.1.7 查看 项 目 


下 面 来 核实 Django 正 确 地 创建 了 项 目 。 为 此 ， 可 使 用 命令 
runserver 查看 项 目的 状态 ， 如 下 所 示 : 


(11_env)learning log$ python manage.py runserver 
Watchman unavailable: pywatchman not installed. 
Watching for file changes with StatReloader 
Performing system checks... 


@ System check identified no issues (6 silenced). 


February 18，2619 - 16:26:67 
@ Django version 2.2.96，using settings 'learning log.settings' 
@ Starting development server at http://127.6.06.1:86066/ 

Quit the server with CONTROL-C. 


Django 启 动 了 一 个 名 为 development server 的 服务 器 ， 让 你 能 够 查看 
系统 中 的 项 目 ， 了 解 其 工作 情况 。 如 果 你 在 浏览 器 中 输入 URL 以 请 
求 页 面 ， 该 Django 服 务 器 将 进行 啊 应 : 生成 合适 的 页 面 ， 并 将 其 发 
运 给 浏览 党 : 


Django 在 @ 处 通过 检查 确认 正确 地 创建 了 项 目 ， 在 全 处 指出 使 用 的 
Django 版 本 以 及 当前 使 用 的 设置 文件 的 名 称 ， 并 在 全 处 指出 项 目的 
URL。URL http://127.0.0.1:8000/ 表 明 项 目 将 在 你 的 计算 机 〔 即 
localhost) 的 端口 8000 上 侦 听 请 求 。localhost 指 的 是 只 处 理 当 前 系 
出 的 请 求 ， 而 不 允许 其 他 任何 人 查看 你 正在 开发 的 页 面 的 服务 


现在 打开 一 蒜 Web 浏 览 费 ， 并 输入 URL http://localhost:8000/〔 如 果 
这 不 管用 ， 请 输入 http:/127.0.0.1:8000/) 。 你 将 看 到 类 似 于 图 18-1 


所 示 的 页 面 。 这 个 页 面 是 Django 创 建 的 ， 让 你 知道 到 目前 为 止 一 切 
正常 。 现 在 暂时 不 要 关闭 这 个 服务 器 ， 等 你 要 关闭 这 个 服务 器 时 ， 
可 切换 到 执行 命令 runserver 时 所 在 的 终端 窗口 ， 再 按 Ctrl + C。 


国 周 时 〈《 (© localhost:8000 6 @ 由 加 


django View release notes for Django dev 


FA 


The install worked successfully! Congratulations! 


You are seeing this page because DEBUG=True is in 
your settings file and you have not configured any 
URLs. 


QQ) Django Documentation <>) Tutorial: A Polling App se Django Community 
~” Topics, references, & how-tos Get started with Django Connect, get help, or contribute 


图 18-1 到 目前 为 止 一 切 正常 


注意 ”如 果 出 现 错 误 消 息 That port is already in use (指定 端口 
被 占用 ) ， 请 执行 命令 python manage.py runserver 8661 
， 让 Diango 使 用 另 一 个 端口 。 如 果 这 个 端口 也 不 可 用 ， 请 不 断 
执行 上 述 命令 ， 并 逐渐 增 大 其 中 的 端口 号 ， 直 到 找到 可 用 的 站 
口 。 


动手 试 一 试 


练习 18-1: 新 项 目 ”为 深入 了 解 Django 都 做 了 些 什 么 ， 可 创建 
两 个 空 项 目 ， 看 看 Django 创 建 了 什么 。 新 建 一 个 文件 来 ， 并 给 
它 指 定 简单 的 名 称 ， 如 snap_gram 或 insta_chat 〈 不 要 在 目录 

learning log 中 新 建 该 文件 夹 ) 。 在 终端 中 切换 到 该 文件 来 ， 并 
创建 一 个 虚拟 环境 。 在 这 个 虚拟 环境 中 ， 安 装 Django， 并 执行 
命令 django-admin.py startproject snap_gram . (和 干 


万 不 要 筷 了 这 个 命令 末尾 的 句点 )。 


看 看 这 个 命令 创建 了 哪些 文件 和 文件 来 ， 并 与 项 目 “ 学 习 笔 
记 ” 包 含 的 文件 和 文件 夹 进行 比较 。 这 样 多 做 几 次 ， 直 到 你 对 


Django 新 建 项 目 时 创建 的 东西 了 如 指 掌 。 然 后 ， 将 项 目 目录 删 
除 《〈 如 有 果 你 想 这 样 做 的 话 ) 。 


18.2 ”创建 应 用 程序 


Django 项 目 由 一 系列 应 用 程序 组 成 ， 它 们 协同 工作 让 项 目 成 为 一 
个 整体 。 本 章 只 创建 一 个 应 用 程序 ， 它 将 完成 项 目的 大 部 分 工作 。 
第 19 章 将 添加 一 个 管理 用 户 账户 的 应 用 程序 。 


当前 ， 在 前 面 打 开 的 终端 窗口 中 应 该 还 运行 着 runserver 。 请 再 打 
开 一 个 终端 窗口 (或 标签 页 ) ， 并 切换 到 manage.py 所 在 的 目录 。 
激活 虚拟 环境 ， 再 执行 命令 startapp : 


learning log$ source 11_env/bin/activate 

(11_env)learning log$ python manage.py startapp learning logs 
@ (ll] env)learning log$ 1s 

db.sqlite3 learning log learning logs 1l1 env manage.py 


@ (ll1 env)learning log$ ls learning logs/ 
_ init_ .py admin.py apps.py migrations models.py tests.py views.py 


命令 startapp appname 让 Django 搭 建 创建 应 用 程序 所 需 的 基础 
设施 。 如 果 现 在 查看 项 目 目录 ， 将 看 到 其 中 新 增 了 文件 夹 
learning_logs( 见 @) 。 打 开 这 个 文件 来， 看 看 Django 都 创建 了 什 
么 〈 见 人 @) ， 其 中 最 重要 的 文件 是 models.py、admin.py 和 
views.py。 我 们 将 使 用 models.py 来 定义 要 在 应 用 程序 中 管理 的 数 
据 ， 稍 后 再 介绍 admin.py 和 views.py。 


18.2.1 定义 模型 

我 们 来 想 想 涉及 的 数据 。 每 位 用 户 都 需要 在 学 习 笔 记 中 创建 很 多 主 
题 。 用 户 输 入 的 每 个 条 目 都 与 特定 主题 相关 联 ， 这 些 条 目 将 以 文本 
的 方式 显示 。 我 们 还 需要 存储 每 个 条 目的 时 间 惟 ， 以 便 告 诉 用 户 各 
个 条 目 都 是 什么 时 候 创 建 的 。 


打开 文件 models.py， 看 看 它 当前 包含 哪些 内 容 : 


models.py 


from django.db import models 


# 在 这 里 创建 模型 。 


这 里 导入 了 模块 models ， 并 让 我 们 创建 自己 的 模型 。 模 型 告诉 
Django 如 何 处 理应 用 程序 中 存储 的 数据 。 在 代码 层面 ， 模 型 束 是 一 

个 类 ， 就 像 前 面 讨论 的 每 个 类 一 样 ， 包 含 属 性 和 方法 。 下 面 是 表示 
用 户 将 存储 的 主题 的 模型 


from django.db import models 


class Topic(models .Model): 

"" 用 户 学 习 的 主题 。""" 

text = models.CharField(max_length=2060) 

date added = models.DateTimeField(auto now add=True) 


def _str (self): 
"返回 模型 的 字符 串 表示 。""" 
return self.text 


我 们 创建 了 一 个 名 为 Topic 的 类 ， 它 继承 Model ， 即 Django 中 定义 
了 模型 基本 功能 的 类 。 我 们 给 Topic 类 添加 了 两 个 属性 text 和 
date _ added 。 


人 是 一 个 CharField 一 一 由 字 符 组 成 的 数据 ， 即 文本 〔 见 
@) 。 需要 存储 少量 文本 ， 如 名 称 、 标 题 或 城市 时 ， 可 使 

用 CharField 。 定义 CharField 属性 时 ， 必 须 告诉 Django 该 在 数 
据 库 中 预 留 多 少 空间 。 这 里 将 max_length 设置 成 了 200( 即 200 字 
和 从) ， 这 对 存储 大 多 数 主题 名 来 说 足够 了 。 


属性 date_added 是 一 个 DateTimeField 一 一 记录 日 期 和 时 间 的 数 
据 ( 见 @) 。 我 们 传递 了 实 参 auto_now_add=True ， 每 当 用 户 创 
建新 主题 时 ，Django 都 会 将 这 个 属性 自动 设置 为 当前 日 期 和 时 间 。 


注意 ”要 获悉 可 在 模型 中 使 用 的 各 种 字段 ， 请 参阅 Django 
Model Field Reference 。 就 当前 而 言 ， 你 无 须 全 面 了 解 其 中 的 
内 容 ， 但 自己 开发 应 用 程序 时 ， 这 些 内 容 将 提供 极 大 的 大 
助 。 


需要 告诉 Django， 默 认 使 用 哪个 属性 来 显示 有 关 主 题 的 信息 。 
Django 调 用 方法 _str _() 来 显示 模型 的 简单 表示 。 这 里 编写 了 方 
法 _str _()， 它 返回 存储 在 属性 text 中 的 字符 串 〈( 见 @) 。 


18.2.2 ”激活 模型 

要 使 用 这 些 模型 ， 必 须 让 Django 将 前 述 应 用 程序 包含 到 项 目 中 。 为 
此 ， 打 开 settings.py〔 它 位 于 目录 learning_log/learning_ log 中) ， 其 
中 有 个 请 段 告诉 Django 哪 些 应 用 程序 被 安装 到 了 项 目 中 并 将 协同 工 
作 : 


settings.py 


--Snip-- 

INSTALLED_APPS = [ 
"django.contrib.admin '， 
"django.contrib .auth ' ， 
"django.contrib .contenttypes ' ， 
"django.contrib.sessions '， 


"django.contrib.messages ， 
"django.contrib .staticfiles '， 


] 


--Snip-- 


请 将 INSTALLED_APPS 修改 成 下 面 这 样 ， 将 前 面 的 应 用 程序 添加 到 
这 个 列表 中 : 


--Snip-- 
INSTALLED_APPS = [ 
# 我 的 应 用 程序 


"learning logs', 


# 默认 添加 的 应 用 程序 


"django.contrib.admin', 
--Snip-- 


] 


--Snip-- 


通过 将 应 用 程序 编组 ， 在 项 目 不 断 增 大 ， 包 含 更 多 的 应 用 程序 时 ， 
有 助 于 对 应 用 程序 进行 跟踪 。 这 里 新 建 了 一 个 名 为 “我 的 应 用 程 
序 ” 的 片段 ， 当 前 它 只 包含 应 用 程序 learning_logs 。 务 必 将 自己 
0 这 样 能 够 覆盖 默认 应 用 程 
子 的 行为 。 


接 下 来 ， 需 要 让 Django 修 改 数据 库 ， 使 其 能 够 存储 与 模型 Topic 相 
关 的 信息 。 为 此 ， 在 终端 窗口 中 执行 下 面 的 命令 : 


(11_env)1learning_log$ python manage.py makemigrations learning logs 
Migrations for 'learning logs': 
learning_logs/migrations/6661_ initial.py 


- _ Create model Topic 
(11_env)learning log$ 


命令 makemigrations 让 Django 确 定 该 如 何 修改 数据 库 ， 使 其 能 够 
存储 与 前 面 定义 的 新 模型 相关 联 的 数据 。 输 出 表明 Django 创 建 了 一 
个 名 为 0001_initial.py 的 迁移 文件 ， 这 个 文件 将 在 数据 库 中 为 模型 
Topic 创建 一 个 表 。 


下 面 应 用 这 种 迁移 ， 让 Django 替 我 们 修改 数据 库 : 


(11_env)learning log$ python manage.py migrate 
Operations to perform : 
Apply all migrations: admin, auth, contenttypes, learning logs, se 


Running migrations : 
© Applying learning logs.6661_ initial... OK 


这 个 命令 的 大 部 分 输出 与 首次 执行 命令 migrate 的 输出 相同 。 需 要 
检查 的 是 @ 处 的 输出 行 。 在 这 里 ，Django 指 出 为 learning_logs 
应 用 迁移 时 一 切 正常 。 


每 当 需 要 修改 “学 习 笔 记 ” 管 理 的 数据 时 ， 都 采取 如 下 三 个 步骤 : 修 
改 models.py， 对 learning_logs 调用 makemigrations ， 以 及 让 
Django 迁 移 项 目 。 


18.2.3 Django 管理 网 站 


Django 提 供 的 管理 网 站 (admin site) 让 你 能 够 轻松 地 处 理 模型 。 
网 站 管理 员 可 以 使 用 管理 网 站 ， 但 普通 用 户 不 能 使 用 。 本 节 将 建立 
管理 网 站 ， 并 通过 它 使 用 模型 Topic 来 添加 一 些 主题 。 


a. 创建 超级 用 户 


Django 人 允许 创建 具备 所 有 权限 的 用 户 ， 即 超级 用 户 。 权 限 决 
定 了 用 户 可 执行 的 操作 。 最 严格 的 权限 设置 只 允许 用 户 阅读 网 
站 的 公开 信息 。 注 册 用 户 通常 可 阅读 自己 的 私有 数据 ， 还 可 查 
看 一 些 只 有 会 员 才 能 查看 的 信息 。 为 有 效 地 管理 Web 应 用 程 

序 ， 网 站 所 有 者 通常 需要 访问 网 站 存储 的 所 有 信息 。 优 秀 的 管 
理 员 会 小 心 对 待 用 户 的 敏感 信息 ， 因 为 用 户 极其 信任 自己 访问 
的 应 用 程序 。 


为 在 Django 中 创建 超级 用 户 ， 请 执行 下 面 的 命令 并 按 提示 做 : 


(11_env)learning log$ python manage.py createsuperuser 


@ Username (leave blank to use 'eric'): 11_admin 
@ Email address: 
日 Password : 
Password (again) : 
Superuser created successfully. 
(11_env)learning log$ 


你 执行 命令 createsuperuser 时 ，Django 提 示 输 入 超级 用 户 
的 用 户 名 ( 见 @) 。 这 里 输入 的 是 1_admin， 但 可 输入 任何 用 
户 名 。 如 果 你 愿意 ， 可 以 输入 电子 邮箱 地 址 ， 也 可 让 这 个 字段 
为 空 〈 见 贸 ) 。 需 要 输入 密码 两 次 ( 见 @) 。 


注意 ”一些 敏感 信息 可 能 会 向 网 站 管理 员 隐 藏 。 例 如 ， 
Django 并 不 存储 你 输入 的 密码 ， 而 是 存储 从 该 密码 派生 出 
来 的 一 个 字符 串 ， 称 为 散 列 值 。 每 当 你 输入 密码 时 ， 
Django 虱 计算 其 散 列 值 ， 并 将 结果 与 存储 的 散 列 值 进行 比 
较 。 如 果 这 两 个 散 列 值 相同 ， 你 就 通过 了 身份 验证 。 由 于 
存储 的 是 散 列 值 ， 即 便 黑 客 获 得 了 网 站 数据 库 的 访问 权 ， 


也 只 能 获取 其 中 存储 的 散 列 值 ， 无 法 获得 密码 。 在 网 站 配 
置 正 确 的 情况 下 ， 几 乎 无 法 根据 散 列 值 推导 出 原始 密码 。 


b. 向 管理 网 站 注册 模型 


Django 上 自动 在 管理 网 站 中 添加 了 一 些 模型 ， 如 User 和 Group 
， 但 对 于 我 们 创建 的 模型 ， 必 须 手 工 进 行 注 册 。 


我 们 创建 应 用 程序 learning_logs 时 ，Django 在 models.py 所 
在 的 目录 中 创建 了 一 个 名 为 admin.py 的 文件 : 


admin.py 


from django.contrib import admin 


# 在 这 里 注册 你 的 模型 。 


为 向 管理 网 站 注册 Topic ， 请 输入 下 面 的 代码 : 
from django.contrib import admin 


@ from .models import Topic 


@ admin.site.register(Topic) 


这 些 代 码 首 先导 入 要 注册 的 模型 Topic ( 见 @) 。models 前 
面 的 句点 让 Django 在 admin.py 所 在 的 目录 中 查找 
models.py。admin.site.register() 让 Django 通 过 管理 网 站 
管理 模型 ( 见 @) 。 


现在 ， 使 用 超级 用 户 账 户 访问 管理 网 站 : 访问 
http://localhost:8000/admin/， 并 输入 刚 创 建 的 超级 用 户 的 用 户 
名 和 和 密码。 你 将 看 到 类 似 于 图 18-2 所 示 的 屏幕 。 这 个 页 面 让 你 
能 够 添加 和 修改 用 户 和 用 户 组 ， 还 可 管理 与 刚才 定义 的 模型 


Topic 相关 的 数据 。 


@iGiBU > 册 的 localhost:8000/admin/ S| © 器 


加 Eeexztelulliitsitileil 


Site administration 


AUTHENTICATION AND AUTHORIZATION 


Groups 十 Add Change 


Users 十 Add Change My actions 


LEARNING_LOGS 


Topics 十 Add Change 


图 18-2 包含 模型 Topic 的 管理 网 站 


注意 “如果 在 浏览 器 中 看 到 一 条 消息 ， 指 出 访问 的 网 页 
不 可 用 ， 请 确认 在 终端 窗口 中 运行 着 Django 服 务 器 。 如 果 
没有 ， 请 激活 虚拟 环境 ， 并 执行 命令 python manage.py 
runserver 。 在 开发 过 程 中 ， 如 有 果 无 法 通过 浏览 器 访问 项 
目 ， 首 先 应 采取 的 故障 排除 措施 是 ， 关 闭 所 有 打开 的 终 
端 ， 再 打开 终端 并 执行 命令 runserver 。 


c， 添加 主题 


癌 管理 网 站 注册 Topic 后 ， 我 们 来 添加 第 一 个 主题 。 为 此 ， 单 
击 Topics 进 入 主题 页 面 ， 它 几乎 是 空 的 ， 因 为 还 没有 添加 任何 
主题 。 单 击 Add， 将 出 现 一 个 用 于 添加 新 主题 的 表单 。 在 第 一 
个 方 框 中 输入 Chess ， 再 单 击 Save 回 到 主题 管理 页 面 ， 其 中 包 
含 刚 创建 的 主题 。 


下 面 再 创建 一 个 主题 ， 以 便 有 更 多 的 数据 可 供 使 用 。 再 次 单 击 
Add， 并 输入 Rock Climbing， 然 后 单 击 Save 回 到 主题 管理 页 
面 。 现 在 ， 你 可 以 看 到 其 中 包含 了 主题 Chess 和 Rock 
Climbing 。 


18.2.4 定义 模型 Entry 


要 记录 学 到 的 国际 象棋 和 攀岩 知识 ， 用 户 必 须 能 够 在 学 习 笔记 中 添 
加 条 目 。 为 此 ， 需 要 定义 相关 的 模型 。 每 个 条 目 都 与 特定 主题 相关 
联 ， 这 种 关系 称 为 多 对 一 关系 ， 即 多 个 条 目 可 关联 到 同一 个 主 


题 。 
下 面 是 模型 Entry 的 代码 ， 请 将 这 些 代码 放 在 文件 models.py 中 : 
models.py 


from django.db import models 


class Topic(models.Model): 
--Snip-- 


@ class Entry(models.Model) : 
""" 学 到 的 有 关 某 个 主题 的 具体 知识 。""" 
topic = models.ForeignKey(Topic, on delete=models .CASCADE) 
text = models.TextField() 
date added = models.DateTimeField(auto now add=True) 


class Meta: 
verbose name plural = 'entries' 


def _str (self): 
"ww un 返回 模型 的 字符 串 表示 。""" 
return f"{self.text[:560]}..." 


像 Topic 一 样 ，Entry 也 继承 了 Django 基 类 Model ( 见 @) 。 第 一 
个 属性 topic 是 个 ForeignKey 实例 〈( 见 @) 。 外 键 (foreign 
key) 是 一 个 数据 库 术 语 ， 它 指 同 数据 库 中 的 男 一 条 记录 ， 这 里 是 
将 每 个 条 目 关 联 到 特定 主题 。 创 建 每 个 主题 时 ， 都 分 配 了 一 个 键 
GD) 。 需 要 在 两 项 数据 之 间 建 立 联 系 时 ，Django 使 用 与 每 项 信息 
相关 联 的 键 。 我 们 稍 后 将 根据 这 些 联 系 获取 与 特定 主题 相关 联 的 所 
有 条 目 。 实 参 on_delete=models .CASCADE 让 Django 在 删除 主题 
的 有 除 所 有 与 之 相关 联 的 条 目 ， 这 称 为 级 联 删除 (cascading 
delete ) 。 


接 下 来 是 属性 text ， 它 是 一 个 TextField 实例 〈 见 人 四) 。 这 种 字 
段 的 长 度 不 受 限 制 ， 因 为 我 们 不 想 限 制 条 目的 长 度 。 属 

性 date_added 让 我 们 能 够 按 创 建 顺序 呈现 条 目 ， 并 在 每 个 条 目 劳 
边 放置 时 间 惟 。 


在 个 处， 我 们 在 Entry 类 中 岁 套 了 Meta 类 。Meta 存储 用 于 管理 模 
型 的 额外 信息 。 在 这 里 ， 它 让 我 们 能 够 设置 一 个 特殊 属性 ， 让 
Django 在 需要 时 使 用 Entries 来 表示 多 个 条 目 。 如 果 没 有 这 个 类 ， 
Django 将 使 用 Entrys 来 表示 多 个 条 目 。 


方法 _str_() 告诉 Django， 呈 现 条 目 时 应 显示 哪些 信息 。 条 目 包 
含 的 文本 可 能 很 长 ， 因 此 让 Django 只 显示 text 的 前 50 字 符 ( 见 
合 ，。 我 们 还 添加 了 一 个 省 略 号 ， 指 出 显示 的 并 非 整 个 条 目 。 


18.2.5 ”迁移 模型 Entry 


添加 新 模型 后 ， 需 要 再 次 迁移 数据 库 。 你 将 慢 慢 地 对 这 个 过 程 了 如 
指 掌 : 修改 models.py， 执 行 命令 python manage.py 
makemigrations app_name ， 再 执行 命令 python manage.py 
migrate 。 


请 使 用 如 下 命令 了 迁移 数据 库 并 查看 输出 : 


(11_env)learning log$ python manage.py makemigrations learning_ logs 
Migrations for 'learning logs': 
@ learning logs/migrations/6662_ entry.py 
- Create model Entry 
(11_env)learning log$ python manage.py migrate 


Operations to perform: 
--Snip-- 
@ Applying learning logs.6662_ entry... OK 


生成 了 一 个 新 的 迁移 文件 0002_entry.py， 它 告诉 Django 如 何 修 改 数 
据 库 ， 使 其 能 够 存储 与 模型 Entry 相关 的 信息 〈 见 @@) 。 在 四 处 执 
行 命令 migrate ， 我 们 发 现 Django 应 用 了 该 迁移 且 一 切 顺 利 。 


18.2.6” 问 管理 网 站 注册 Entry 


我 们 还 需要 注册 模型 Entry 。 为 此 ， 需 要 将 admin.py 修 改 成 类 似 于 
下 面 这 样 : 


admin.py 


from django.contrib import admin 


from .models import Topic, Entry 


admin.site.register(Topic) 
admin.site.register(Entry) 


返回 到 http://localhost/admin/， 你 将 看 到 Learning_Logs 下 列 出 了 
Entries。 单 击 Entries 的 Add 链 接 ， 或 者 单 击 Entries 再 选择 Add 
entry， 将 看 到 一 个 下 拉 列 表 ， 供 你 选择 要 为 哪个 主题 创建 条 目 ， 以 
及 一 个 用 于 输入 条 目的 文本 框 。 从 下 拉 列 表 中 选择 Chess， 并 添加 
一 个 条 目 。 下 面 是 我 添加 的 第 一 个 条 目 。 


The opening is the first part of the game, roughly the first ten 
moves or so. In the opening, it's a good idea to do three things— 
bring out your bishops and knights, try to control the center of the 
board, and castle your king. (国际 象棋 的 第 一 个 阶段 是 开局 ， 大 
致 是 前 10 步 左右 。 在 开局 阶段 ， 最 好 做 三 件 事情 : 将 象 和 马 调 
出 来 ， 努 力 控制 棋盘 的 中 间 区 域 ， 以 及 用 车 将 王 护 住 。) 


Of course, these are just guidelines. It will be important to learn 
when to follow these guidelines and when to disregard these 
suggestions.〔 当然 ， 这 些 只 是 指导 原则 。 学 习 什 么 情况 下 遵守 
这 些 原则 、 什 么 情况 下 不 用 遵守 很 重要 。) 


当 你 单 击 Save 时 ， 将 返回 到 主 条 目 管理 页 面 。 在 这 里 ， 你 将 发 现 使 
用 text[ :58] 作为 条 目的 字符 串 表 示 的 好 处 :在 管理 界面 中 只 显示 
0 00 0 


再 来 创建 一 个 国际 象棋 条 目 ， 并 创建 一 个 攀岩 条 目 ， 以 提供 一 些 初 
始 数据 。 下 面 是 第 二 个 国际 象棋 条 目 。 


In the opening phase of the game, its important to bring out your 
bishops and knights. These pieces are powerful and maneuverable 
enough to play a significant role in the beginning moves of a game. 

在 国际 象棋 的 开局 阶段 ， 将 象 和 马 调 出 来 很 重要 。 这 些 棋子 
威力 大 ， 机 动 性 强 ， 在 开局 阶段 扮演 着 重要 角色 。) 


下 面 是 第 一 个 攀岩 条 目 。 


One of the most important concepts in climbing is to keep your 
weight on your feet as much as possible. There's a myth that 
climbers can hang all day on their arms. In reality, good climbers 
have practiced specific ways of keeping their weight over their feet 
whenever possible.〈 最 重要 的 攀岩 概念 之 一 是 尽 可 能 让 双 脚 承 
受 体重 。 有 人 误 认 为 攀岩 者 能 依靠 手臂 的 力量 坚持 一 整 天 。 实 
人 
本 重 。 ) 


接着 往 下 开发 “学 习 笔 记 ? 时 ， 这 三 个 条 目 提供 了 可 供 使 用 的 数据 。 


18.2.7 Django shell 


输入 一 些 数据 后 ， 束 可 通过 交互 式 终端 会 话 以 编程 方式 查看 这 些 数 
据 了 。 这 种 交互 式 环境 称 为 Django shell ， 是 测试 项 目 和 排除 故障 
的 理想 之 地 。 下 面 是 一 个 交互 式 shell 会 话 示 例 : 


(11_env)learning log$ python manage.py shell 
@ >>> from learning logs.models import Topic 
>>> Topic.objects.all() 


<Queryset [<Topic: Chess>, <Topic: Rock Climbing>]> 


在 活动 状态 的 虚拟 环境 中 执行 时 ， 命 令 python manage.py shell 
启动 Python 解 释 器 ， 让 你 能 够 探索 存储 在 项 目 数据 库 中 的 数据 。 这 
里 导入 了 模块 learning_logs .models 中 的 模型 Topic 〈 见 

@)，， 再 使 用 方法 Topic.objects.all() 获取 模型 Topic 的 所 有 
实例 ， 这 将 返回 一 个 称 为 查询 集 (queryset) 的 列表 。 


可 以 像 志 历 列表 一 样 过 历 查 询 集 。 下 面 演示 了 如 何 伍 看 分 配给 每 个 


主题 对 象 的 ID: 


>>> topics = Topic.objects.all() 
>>> for topic in topics: 
print(topic.id, topic) 


1 Chess 
2 Rock Climbing 


将 返回 的 查询 集 存储 在 topics 中 ， 再 打印 每 个 主题 的 id 属性 和 字 
符 串 表示 。 从 输出 可 知 ， 主 题 Chess 的 ID 为 1， 而 Rock Climbing 的 ID 
为 2。 


知道 主题 对 象 的 ID 后 ， 就 可 使 用 方法 Topic.objects.get() 获取 
该 对 象 并 得 看 其 属性 。 下 面 来 看 看 主题 Chess 的 属性 text 和 
date_added 的 值 : 


>>> 七 = Topic.objects.get(id=1) 

>>> t.text 

"Chess， 

>>> t.date added 
datetime.datetime(2019，2，19，1，55，31，985606，tzinfo=<UTC>) 


我 们 还 可 以 查看 与 主题 相关 联 的 条 目 。 前 面 给 模型 Entry 定义 了 属 
性 topic 。 这 是 一 个 ForeignKey ， 将 条 上 日 与 主题 关联 起 来 。 利 用 
这 种 关联 ，Django 能 够 获取 与 特定 主题 相关 联 的 所 有 条 目 ， 如 下 所 
外 : 


@ >>> t.entry_set.all() 
<Queryset [<Entry: The opening is the first part of the game，rough1] 
<Entry : 


In the opening phase of the game, it's important 七 ...>]> 


要 通过 外 键 关 系 获 取 数 据 ， 可 使 用 相关 模型 的 小 写 名 称 、 下 划 线 和 
单词 set ( 见 @) 。 例如， 假设 有 模型 Pizza 和 Topping ， 


而 Topping 通过 一 个 外 键 关联 到 Pizza 。 如 果 有 一 个 名 
为 my_pizza 的 Pizza 对 象 ， 束 可 使 用 代 
人 码 my_pizza.topping_set.all() 来 获取 这 张 比 萨 的 所 有 配料 。 


编写 用 户 可 请 求 的 页 面 时 ， 我 们 将 使 用 这 种 语法 。 确 认 代 码 能 获取 
所 需 的 数据 时 ，shell 很 有 帮助 。 如 果 代 码 在 shell 中 的 行为 符合 预 
期 ， 那 么 它们 在 项 目 文 件 中 也 能 正确 地 工作 。 如 果 代 码 引 发 了 错误 
或 获取 的 数据 不 符合 预期 ， 那 么 在 简单 的 shel 环 境 中 排除 故障 要 比 
在 生成 页 面 的 文件 中 排除 故障 容易 得 多 。 我 们 不 会 太 多 地 使 用 
shell， 但 应 继续 使 用 它 来 熟悉 对 存储 在 项 目 中 的 数据 进行 访问 的 
Django 语 法 。 


注意 “每 次 修改 模型 后 ， 都 需要 重启 shell， 这 样 才能 看 到 修改 
的 效果 。 要 退出 shell 会 话 ， 可 按 Ctr + D。 如 果 你 使 用 的 是 
Windows 系 统 ， 应 按 Ctr + Z， 再 按 回 车 键 。 


动手 试 一 斌 


练习 18-2: 简短 的 条 目 “当前 ，Django 在 管理 网 站 或 shell 中 显 
示 Entry 实例 时 ， 模 型 Entry 的 方法 _str _() 都 在 其 末尾 加 
上 省 略 写 。 请 在 方法 __str_() 中 添加 一 条 if 语句 ， 以 便 仪 
在 条 目 长 度 超过 50 字 符 时 才 添 加 省 略 号 。 使 用 管理 网 站 添加 一 
个 不 超过 50 字 符 的 条 目 ， 并 核实 显示 它 时 没有 省 略 号 。 


练习 18-3: Django API 当 你 编写 访问 项 目 中 数据 的 代码 

时 ， 实 际 上 编写 的 是 查询 。 请 浏览 Django 网 站 中 有 关 如 何 查询 
数据 的 文档 Making queries ， 其 中 大 部 分 内 容 是 你 不 就 悉 的 ， 
但 等 你 自己 开发 项 目 时 ， 这 些 内 容 会 很 有 用 。 


练习 18-4: 比 蔷 店 ”新 建 一 个 名 为 Pizzeria 的 项 目 ， 并 在 其 中 
添加 一 个 名 为 pizzas 的 应 用 程序 。 定 义 一 个 名 为 Pizza 的 模 
型 ， 它 包含 字段 name ， 用 于 存储 比萨 名 称 ， 如 Hawaiian 和 
Meat Lovers 。 定 义 一 个 名 为 Topping 的 模型 ， 它 包含 字段 
pizza 和 name ， 其 中 字段 pizza 是 一 个 关联 到 Pizza 的 外 

键 ， 而 字段 name 用 于 存储 配料 ， 如 pineapple 、Canadian 


bacon 和 sausage 。 


回 管 理 网 站 注册 这 两 个 模型 ， 并 使 用 管理 网 站 输入 一 些 比萨 名 
和 配料 。 使 用 shell 来 查看 你 输入 的 数据 。 


18.3 创建 页 面 : 学 习 笔 记 主 页 


使 用 Django 创 建 页 面 的 过 程 分 三 个 阶段 : 定义 URL， 编 写 视 图 和 编 
写 模 板 。 按 什么 顺序 完成 这 三 个 阶段 无 关 紧 要 ， 但 在 本 项 目 中 ， 总 
是 先 定 义 URL 模 式 。URL 模 式 描述 了 URL 是 如 何 设计 的 ， 让 Django 
知道 如 何 将 浏览 器 请 求 与 网 站 URL 匹 配 ， 以 确定 返回 哪个 页 面 。 


每 个 URL 痢 个 映射 到 特定 的 视图 一 一 视图 沙 数 获取 并 处 理 页 面 所 
需 的 数据 。 视 图 函数 通常 使 用 模板 来 泻 染 页 面 ， 而 模板 定义 页 面 
的 总 体 结构 。 为 明白 其 中 的 工作 原理 ， 我 们 来 创建 学 习 笔记 的 主 
人 
吴 似 。 


我 们 只 是 要 确保 “学 习 笔记 ” 按 要 求 的 那样 工作 ， 因 此 和 暂时 让 这 个 页 
面 尽 可 能 简单 。Web 应 用 程序 能 够 正常 运行 后 ， 设 置 样 式 可 使 其 更 
有 趣 ， 但 中 看 不 中 用 的 应 用 程序 坚 无 意义 。 就 目前 而 言 ， 主 页 只 旺 
示 标 题 和 简单 的 描述 。 


18.3.1 映射 URL 


用 户 通过 在 浏览 器 中 输入 URL 以 及 单 击 链接 来 请 求 页 面 ， 因 此 我 们 
要 确定 项 目 需要 哪些 URL。 主 页 的 URL 最 重要 ， 它 是 用 户 用 来 访问 
项 目的 基础 URL。 当 前 ， 基 础 URL (http://localhost: 8000/) 返回 默 
认 的 Django 网 站 ， 让 我 们 知道 正确 地 建立 了 项 目 。 下 面 修改 这 一 

点 ， 将 这 个 基础 URL 上 映射 到 “学 习 笔 记 ” 的 主页 。 


打开 项 目 主 文件 夹 learning_ log 中 的 文件 urls.py， 你 将 看 到 如 下 代 
码 : 


urls.py 


@ from django.contrib import admin 
from django.urls import path 


@ urlpatterns = [ 
日 path('admin/', admin.site.urls), 


] 


前 两 行 导入 了 一 个 模块 和 一 个 函数 ， 以 便 对 管理 网 站 的 URL 进 行 管 
理 ( 见 @) 。 这 个 文件 的 主体 定义 了 变量 urlpatterns 〈 见 

四 ) 。 在 这 个 针对 整个 项 目的 urls.py 文 件 中 ， 变 量 urlpatterns 包 
含 项 目 中 应 用 程序 的 URL。 全 处 的 代码 包含 模 

块 admin.site.urls ， 该 模块 定义 了 可 在 管理 网 站 中 请 求 的 所 有 
URL 。 


我 们 需要 包含 learning_logs 的 URL， 因 此 添加 如 下 代码 : 


from django.contrib import admin 
from django.urls import path, include 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('learning logs.urls')), 


在 @ 处 ， 添 加 一 行 代码 来 包含 模块 learning_logs.urls。 


默认 的 urls.py 包 含 在 文件 夹 learning_log 中 ， 现 在 需要 在 文件 夹 

learning_logs 中 再 创建 一 个 urls.py 文 件 。 为 此 ， 新 建 一 个 文件 ， 使 用 

0 i 到 文件 夹 learning_ logs 中 ， 再 在 这 个 文件 中 输 
0 下 代码 : 


urls.py 


@""" 定 义 learning_logs 的 URL 模 式 。""" 


@ from django.urls import path 


@ from . import views 


@ app_name = "learning logs' 
© urlpatterns = [ 
# 主页 


© path('', views.index, name='index'), 


] 


为 指出 当前 位 于 哪个 urls.py 文 件 中 ， 在 该 文件 开头 添加 一 个 文档 字 
符 串 ( 见 @) 。 接 下 来 ， 导 入 了 函数 path ， 因 为 需要 使 用 它 将 
UREL 映 射 到 视图 〈 见 外) 。 我 们 还 导入 了 模块 views ( 见 @) ,其 
中 的 句点 让 Python 从 当前 urls.py 模 块 所 在 的 文件 夹 导入 views.py。 变 
量 app_name 让 Django 能 够 将 这 个 urls.py 文 件 同 项 目 内 其 他 应 用 程 
序 中 的 同名 文件 区 分 开 来 ( 见 @) 。 在 这 个 模块 中 ， 变 量 
urlpatterns 是 一 个 列表 ， 包 含 可 在 应 用 程序 learning_logs 中 
请 求 的 页 面 。 


实际 的 UREL 模 式 是 对 函数 path() 的 调用 ， 这 个 函数 接受 三 个 实 参 
( 见 人 @@) 。 第 一 个 是 一 个 字符 串 ， 帮 助 Django 正 确 地 路 由 《route) 
请 求 。 收 到 请 求 的 URL 后 ，Django 力 图 将 请 求 路 由 给 一 个 视图 。 为 
此 ， 它 搜索 所 有 的 URL 模 式 ， 找 到 与 当前 请 求 臣 配 的 那个 。Django 
忽略 项 目的 基础 URL (http:Wlocalhost:8000/) ， 因 此 空 字符 串 〈”… 
) 与 基础 URL 苞 配 。 其 他 URL 都 与 这 个 模式 不 匹配 。 如 果 请 求 的 

和 


path() 的 第 二 个 实 参 〈 见 @) 指定 了 要 调用 view.py 中 的 哪个 函 
数 。 请 求 的 URL 与 前 述 正则 表达 式 匹 配 时 ，Django 将 调用 view.py 中 
的 函数 index() 〈 这 个 视图 函数 将 在 下 一 节 编 写 ) 。 第 三 个 实 参 将 
这 个 URL 模 式 的 名 称 指定 为 index ， 让 我 们 能 够 在 代码 的 其 他 地 方 
引用 它 。 每 当 需 要 提供 到 这 个 主页 的 链接 时 ， 都 将 使 用 这 个 名 称 ， 
而 不 编写 URL。 


18.3.2 ”编写 视图 
视图 函数 接受 请 求 中 的 信息 ， 准 备 好 生成 页 面 所 需 的 数据 ， 再 将 这 


a #8 一 一 这 通 第 是 使 用 定义 页 面 外 观 的 模板 实现 
aE 


learning_logs 中 的 文件 views.py 是 执行 命令 python manage.py 
startapp 时 自动 生成 的 ， 当 前 其 内 容 如 下 : 


views.py 


from django.shortcuts import render 


# 在 这 里 创建 视图 。 


当前 ， 这 个 文件 只 导入 了 函数 render() ， 它 根据 视图 提供 的 数据 
泻 染 啊 应 。 请 在 这 个 文件 中 添加 为 主页 编写 视图 的 代码 ， 如 下 所 
修 \: 


from django.shortcuts import render 


def index(request): 
""" 学 习 笔记 的 主页 。""" 


return render(request, 'learning logs/index.html') 


URL 请 求 与 刚才 定义 的 模式 匹配 时 ，Django 将 在 文件 views.py 中 查 
找 函 数 index() ， 再 将 对 象 request 传递 给 这 个 视图 函数 。 这 里 不 
需要 处 理 任 何 数据 ， 因 此 这 个 函数 只 包含 调用 render() 的 代码 。 
这 里 同 函 数 render() 提供 了 两 个 实 参 : 对 象 request 以 及 一 个 可 
用 于 创建 页 面 的 模板 。 下 面 来 编写 这 个 模板 。 


18.3.3 ”编写 模板 


模板 定义 页 面 的 外 观 ， 而 每 当 页 面 被 请 求 时 ，Django 将 填 入 相关 的 
数据 。 模 板 让 你 能 够 访问 视图 提供 的 任何 数据 。 我 们 的 主页 视图 没 
有 提供 任何 数据 ， 因 此 相应 的 模板 非常 简单 。 


在 文件 夹 learning_logs 中 新 建 一 个 文件 夹 ， 并 将 其 命名 为 
templates。 在 文件 夹 templates 中 ， 再 新 建 一 个 文件 夹 ， 并 将 其 命名 
为 learning_logs。 这 好 像 有 点 多 余 〈 在 文件 夹 learning_logs 中 创建 文 
件 夹 teamplates， 又 在 这 个 文件 夹 中 创建 文件 夹 learning_ logs) ， 但 
是 建立 了 Django 能 够 明确 解读 的 结构 ， 即 便 项 目 很 大 、 包 含 很 多 应 
用 程序 亦 如 此 。 在 最 里 面 的 文件 夹 learning_logs 中 ， 新 建 一 个 文 
件 ， 并 将 其 命名 为 index.html (这 个 文件 的 路 径 为 

learning log/learning logs/templates/ learning logs/index.html) ， 再 
在 其 中 编写 如 下 代码 : 


index.html 


<p>Learning Log</p> 


<p>Learning Log helps you keep track of your learning, for any topic y 


learning about.</p> 


这 个 文件 非常 简单 。 这 里 向 不 熟悉 HTML 的 读者 解释 一 下 : 标签 

<p></p> 标识 段落 。 标 签 <p> 指出 段落 的 开头 位 置 ， 而 标签 </p> 

出 段落 的 结束 位 置 。 这 里 定义 了 两 个 段落 第 一 个 充当 标题 ， 第 
二 个 阐述 了 用 户 可 使 用 “学 习 笔 记 ” 来 做 什么 。 


现在 ， 如 果 请 求 这 个 项 目的 基础 URL http://localhost:8000/， 将 看 到 
刚才 创建 的 页 面 ， 而 不 是 默认 的 Django 页 面 。Django 接 受 请 求 的 

URL， 发 现 该 URL 与 模式 '' 匹配 ， 因 此 调用 函数 views.index() 
。 这 将 使 用 index.html 包 含 的 模板 来 泻 染 页 面 ， 结 果 如 图 18-3 所 示 。 


@ DB | < @ localhost:8000 & @ 由 5 本 
-一 < 一 一 一 一 一 一 一 一 一 一 < 一 一 一 一 一 一 一 一 一 人 


Learning Log 


Learning Log helps you keep track of your learning, for any topic you're learning abonut. 


图 18-3” 学习 笔记 的 主页 


创建 页 面 的 过 程 看 起 来 可 能 很 复 傈 ， 但 将 URL、 视 图 和 模板 分 离 的 
效果 很 好 。 这 让 我 们 能 够 分 别 考虑 项 目的 不 同方 面 ， 在 项 目 很 大 
时 ， 可 让 各 个 参与 者 专注 于 最 擅长 的 方面 。 例 如 ， 数 据 库 专家 专注 
于 模型 ， 程 序 员 专注 于 视图 代码 ， 而 Web 设 计 人 员 专 注 于 模板 。 


注意 “可 能 出 现 如 下 错误 消息 : 


ModuleNotFoundError: No module named 'learning logs.urls’ 


如 果 确 实 如 此 ， 请 在 执行 命令 python manage.py 
runserver 的 终端 窗口 中 按 Ctrl + C 停 用 服务 器 ， 再 重新 执行 
这 个 命令 。 这 样 做 后 ， 应 该 能 够 看 到 主页 。 每 当 遇 到 类 似 的 错 
误 时 ， 都 尝试 停 用 并 重启 服务 器 ， 看 看 是 否 管用 。 


动手 试 一 斌 


练习 18-5: 膳食 规划 程序 ”假设 你 要 创建 一 个 应 用 程序 ， 帮 
助 用 户 规划 一 周 的 膳食 。 为 此 ， 新 建 一 个 文件 夹 ， 并 将 其 命名 
为 meal_planner， 再 在 这 个 文件 夹 中 新 建 一 个 Django 项 目 。 然 
后 ， 新 建 一 个 名 为 meal_plans 的 应 用 程序 ， 并 为 这 个 项 目 创 
建 一 个 简单 的 主页 。 


练习 18-6: 比 院 店主 页 ”在 为 完成 练习 18-4 而 创建 的 项 目 
Pizzeria 中 ， 添 加 一 个 主页 。 


18.4 创建 其 他 页 面 


制定 创建 页 面 的 流程 后 ， 可 以 开始 扩充 “学 习 笔 记 ? 项 目 了 。 我 们 将 
创建 两 个 显示 数据 的 页 面 ， 其 中 一 个 列 出 所 有 的 主题 ， 为 一 个 显示 
特定 主题 的 所 有 条 目 。 对 于 每 个 页 面 ， 我 们 都 将 指定 URL 人 模式、 编 
写 一 个 视图 函数 并 编写 一 个 模板 。 但 这 样 做 之 前 ， 我 们 先 创 建 一 个 
父 模板 ， 项 目 中 的 其 他 模板 都 将 继承 它 。 


18.4.1 模板 继承 


创建 网 站 时 ， 一 些 通用 元 素 几 乎 会 在 所 有 页 面 中 出 现 。 在 这 种 情况 
下 ， 可 编写 一 个 包含 通用 元 素 的 父 模板 ， 并 让 每 个 页 面 都 继承 这 个 
模板 ， 而 不 必 在 每 个 页 面 中 重复 定义 这 些 通 用 元 素 。 这 种 方法 能 让 
你 专注 于 开发 每 个 页 面 的 独特 方面 ， 还 能 让 修改 项 目的 整体 外 观 容 
易 得 多 。 
a， 父 模板 
下 面 创 建 一 个 名 为 base.html 的 模板 ， 并 将 其 存储 在 index.html 所 
在 的 目录 中 。 这 个 模板 包含 所 有 页 面 都 有 的 元 素 ， 而 其 他 模板 
都 继承 它 。 当 前 ， 所 有 页 面 都 包含 的 元 了 素 只 有 顶端 的 标题 。 因 


I 
链接 : 


base.html 


<p> 
@ «a href="{% url "learning logs:index' %}">Learning Log</a> 


</p> 


@ {% block content %}{% endblock content %} 


这 个 文件 的 第 一 部 分 创建 一 个 包含 项 目 名 的 段落 ， 该 段落 也 是 
到 主页 的 链接 。 为 创建 链接 ， 使 用 了 一 个 模板 标签 ， 它 是 用 
化 括号 和 百 分 号 〈{% %} ) 表示 的 。 模 板 标 签 古 一 小 段 代 码 ， 


生成 要 在 页 面 中 显示 的 信息 。 这 里 的 模板 标签 {% url 
'Jearning logs:index' %} 生成 一 个 URL， 该 URL 与 在 
learning_logs/urls.py 中 定义 的 名 为 'ijndex" 的 URL 模 式 匹 配 

( 见 @) 。 在 本 例 中 ，learning_logs 是 一 个 命名 空间 ， 
而 index 是 该 命名 空间 中 一 个 名 称 独特 的 URL 模 式 。 这 个 命名 
空间 来 自在 文件 learning_logs/urls.py 中 赋 给 app_name 的 值 。 


在 简单 的 HTML 页 面 中 ， 链 接 是 使 用 锚 标签 ca> 定义 的 : 


<a _ href="1link_ur1">l1ink text</a> 


通过 使 用 模板 标签 来 生成 URL， 能 很 容易 地 确保 链接 是 最 新 
的 : 只 需 修 改 urls.py 中 的 URL 模 式 ，Django 就 会 在 页 面 下 次 被 
请 求 时 自动 插入 修改 后 的 URL。 在 本 项 目 中 ， 每 个 页 面 都 将 继 
承 base.htm1， 因 此 从 现在 开始 ， 每 个 页 面 都 包含 到 主页 的 链 
接 。 


在 全 处， 我 们 插入 了 一 对 块 标签 。 这 个 块 名 为 content ， 是 
一 个 占 位 符 ， 其 中 包含 的 信息 由 子 模板 指定 。 


子 模 板 并 非 必须 定义 父 模 板 中 的 每 个 块 ， 因 此 在 父 模 板 中 ， 可 
使 用 任意 多 个 块 来 预 留 空间 ， 而 子 模板 可 根据 需要 定义 相应 数 


量 的 块 。 


注意 ”在 Python 代 码 中 ， 几 乎 总 是 缩 进 四 个 空格 。 相 比 于 
Python 文件 ， 模 板 文 件 的 缩 进 层 级 更 多 ， 因 此 每 个 层级 通 
常 只 缩 进 两 个 空格 。 每 个 层级 缩 进 多 少 个 空格 无 天 紧要 ， 

只 需 确保 一 致 即 可 。 


. 于 模板 


现在 需要 重 写 index.html， 使 其 继承 base.html。 为 此 ， 问 
index.html 添 加 如 下 代码 : 


index.html 


@ {% extends "learning logs/base.html" %} 


@ {% block content %} 
<p>Learning Log helps you keep track of your learning, for any 


learning about.</p> 
e@ {% endblock content %} 


如 果 将 这 些 代 人 码 与 原来 的 index.html 进 行 比 较 ， 将 发 现 标 题 
Learning Log 没 有 了 ， 取 而 代 之 的 是 指定 要 继承 哪个 模板 的 代 
码 ( 见 @) 。 子 模板 的 第 一 行 必须 包含 标签 {% extends %} 

， 让 Django 知 道 它 继承 了 哪个 父 模板 。 文 件 base.html 位 于 文件 
夹 learning_logs 中 ， 因 此 父 模板 路 径 中 包含 learning_logs。 这 行 
代码 导入 模板 base.html 的 所 有 内 容 ， 让 index.html 能 够 指定 要 
在 content 块 预 留 的 空间 中 添加 的 内 容 。 


在 四 处 ， 插 入 了 一 个 名 为 content 的 {% block %} 标签 ， 以 
定义 content 块 。 不 是 从 父 模 板 继承 的 内 容 都 包含 在 content 
块 中 ， 在 这 里 是 一 个 描述 项 目 “ 学 习 笔 记 ” 的 段落 。 在 个 处 ， 使 
用 标签 {% endblock content %} 指出 了 内 容 定 义 的 结束 位 
置 。 在 标签 {% endblock %} 中 ， 并 非 必须 指定 块 名 ， 但 如 果 
模板 包含 多 个 块 ， 指 定 块 名 有 助 于 确定 结束 的 是 哪个 块 。 


模板 继承 的 优点 开始 显现 出 来 了 : 在 子 模板 中 ， 只 需 包 含 当前 
页 面 特有 的 内 容 。 这 不 仅 简化 了 每 个 模板 ， 还 使 得 网 站 修改 起 
来 容易 得 多 。 要 修改 很 多 页 面 都 包含 的 元 素 ， 只 需 修改 父 模 板 
即 可 ， 所 做 的 修改 将 传导 到 继承 该 父 模 板 的 每 个 页 面 。 在 包 合 
个 页 面 的 项 目 中 ， 这 种 结构 使 得 网 站 改进 起 来 更 
容 、 | O 


注意 ”在 大 型 项 目 中 ， 通 常 有 一 个 用 于 整个 网 站 的 父 模 
板 base.html， 且 网 站 的 每 个 主要 部 分 都 有 一 个 父 模板 。 
个 部 分 的 父 模板 都 继承 base.html， 而 网 站 的 每 个 页 面 都 继 
承 相 应 部 分 的 父 模板 。 这 让 你 能 够 轻松 地 修改 整个 网 站 的 
外 观 、 网 站 任何 一 部 分 的 外 观 以 及 任何 一 个 页 面 的 外 观 。 
这 种 配置 提供 了 一 种 效率 极 高 的 工作 方式 ， 让 你 乐意 不 断 
地 去 改进 网 站 。 


18.4.2 ”显示 所 有 主题 的 页 面 


有 了 了 高效 的 页 面 创建 方法 ， 就 能 专注 于 为 外 两 个 页 面 了 : 显示 所 有 
主题 的 页 面 和 显示 特定 主题 中 条 目的 页 面 。 前 者 显示 用 户 创 建 的 所 
有 主题 ， 它 是 第 一 个 需要 使 用 数据 的 页 面 。 


a.，URL 模 式 


首先 ， 定 义 显示 所 有 主题 的 页 面 的 URL。 我 们 通常 使 用 一 个 简 
单 的 URL 厂 段 来 指出 页 面 显 示 的 信息 ， 这 里 使 用 单词 topics， 
此 URL http://localhost:8000/topics/ 将 返回 显示 所 有 主题 的 页 
而 。 下 面 演 示 了 该 如 何 修改 learning_logs/urls.py: 


urls.py 


""" 为 learning_logs 定 义 URL 模 式 。""" 
--Snip-- 
urlpatterns = [ 

# 主页 

path('', views.index, name='index'), 


# 显示 所 有 的 主题 。 
@ path('topics/', views.topics, name="'topics'), 


] 


这 里 在 用 于 主页 URL 的 字符 串 参 数 中 添加 了 topics/ ( 见 
@) 。Django 检 查 请 求 的 URL 时 ， 这 个 模式 与 如 下 URL 匹 配 : 
基础 UREL 后 面 跟着 topics。 可 在 末尾 包含 斜 枉 ， 也 可 省 略 ， 但 
单词 topics 后 面 不 能 有 任何 东西 ， 和 否则 就 与 该 模式 不 匹配 。 
URL 与 该 模式 匹配 的 请 求 都 将 交 给 views.py 中 的 函数 topics() 
处 理 。 


b. 视图 


函数 topics() 需要 从 数据 库 中 获取 一 些 数据 ， 并 将 其 交 给 给 
模板 。 需 要 在 views.py 中 添加 的 代码 如 下 : 


views.py 


from django.shortcuts import render 
@ from .models import Topic 


def index(request): 
--Snip-- 


@ def topics(request): 
"" "显示 所 有 的 主题 。""" 
[3 topics = Topic.objects.order by('date added') 
@ context = {'topics': topics} 
© return render(request, 'learning logs/topics.html', context 


首先 导入 与 所 需 数据 相关 联 的 模型 ( 见 @) 。 函 数 topics() 
包含 一 个 形 参 : Django 从 服务 器 那里 收 到 的 request 对 象 〈 见 
全 ) 。 在 全 处 ， 查 询 数 据 库 一 一 请 求 提供 Topic 对 象 ， 并 根据 
eked 进行 排序 。 返 回 的 查询 集 被 存储 在 topics 


在 全 处 ， 定 义 一 个 将 发 送 给 模板 的 上 上 下文。 上下文 是 一 个 字 
典 ， 其 中 的 键 是 将 在 模板 中 用 来 访问 数据 的 名 称 ， 而 值 是 要 发 
送 给 模板 的 数据 。 这 里 只 有 一 个 键 值 对 ， 包 含 一 组 将 在 页 面 中 
显示 的 主题 。 创 建 使 用 数据 的 页 面 时 ， 除 了 对 象 request 和 模 
板 的 路 径 外 ， 还 将 变量 context 传递 给 render() ( 见 @)。 


. 模板 


显示 所 有 主题 的 页 面 的 模板 接受 字典 context ， 以 便 使 

用 topics() 提供 的 数据 。 请 创建 一 个 文件 ， 将 其 命名 为 
topics.html， 并 存储 到 index.html 所 在 的 目录 中 。 下 面 演示 了 如 
何在 这 个 模板 中 显示 主题 : 


topics.html 


{% extends "learning logs/base.html" %} 


{% block content %} 


<p>Topics</p> 


@ <ul> 
@ {% for topic in topics %} 
@ <1i>{{ topic }}</1i> 
@ {% empty %} 
<1i>No topics have been added yet.</1i> 
9 {% endfor %} 
© 《</ul> 


{% endblock content %} 


就 像 模板 index.html 中 一 样 ， 首 先 使 用 标签 {% extends %} 来 
继承 base.html， 再 开始 定义 content 块 。 这 个 页 面 的 主体 是 一 
个 项 目 列 表 ， 其 中 列 出 了 用 户 输入 的 主题 。 在 标准 HTML 中 ， 

项 目 列 表 称 为 无 序列 表 ， 用 标签 cul></ul> 表示 。 包 含 所 有 
主题 的 项 目 列 表 始 于 @ 处 。 


在 全 处 ， 使 用 一 个 相当 于 for 循环 的 模板 标签 ， 它 遍历 字 

典 context 中 的 列表 topics 。 模 板 中 使 用 的 代码 与 Python 代 
码 存在 一 些 重要 差别 : Python 使 用 缩 进来 指出 哪些 代码 行 

是 for 循环 的 组 成 部 分 ， 而 在 模板 中 ， 每 个 for 循环 都 必须 使 
用 {% endfor %} 标签 来 显 式 地 指出 其 结束 位 置 。 因 此 在 模板 
中 ， 循 环 类 似 于 下 面 这 样 : 


{% for item in list %} 
do something with each item 
{% endfor %} 


在 循环 中 ， 要 将 每 个 主题 转换 为 项 目 列表 中 的 一 项 。 要 在 模板 
中 打印 变量 ， 需 要 将 变量 名 用 双 花 括号 括 起 。 这 些 花 括号 不 会 
出 现在 页 面 中 ， 只 是 用 于 告诉 Django 我 们 使 用 了 一 个 模板 变 
量 。 因 此 每 次 循环 时 ， 全 处 的 代码 {{ topic }} 都 被 蔡 换 
为 topic 的 当前 值 。HTML 标 签 <li></1i> 表示 一 个 项 目 列 表 
项 。 在 标签 对 <ul></ul> 内 部 ， 位 于 标签 <11> 和 </1i> 之 间 
的 内 容 都 是 一 个 项 目 列表 项 。 


在 人 四处， 使 用 模板 标签 {% empty %} ， 它 告诉 Django 在 列 

表 topics 为 空 时 该 如 何 办 。 这 里 是 打印 一 条 消息 ， 告 诉 用 户 
还 没有 添加 任何 主题 。 最 后 两 行 分 别 结束 for 循环 〈( 见 @) 和 
项 目 列 表 ( 见 @) 。 


现在 需要 修改 父 模 板 ， 使 其 包含 到 显示 所 有 主题 的 页 面 的 链 
接 。 为 此 ， 在 其 中 添加 如 下 代码 : 


base.html 


<p> 
@ «a href="{% url 'learning logs:index' %}">Learning Log</a> - 
@ <a href="{% url 'learning logs:topics' %}">Topics</a> 

</p> 


{% block content %}{% endblock content %} 


在 到 主页 的 链接 后 面 添加 一 个 连 字 符 ( 见 @)〉， 再 添加 一 个 到 
显示 所 有 主题 的 页 面 的 链接 一 一 使 用 的 也 是 模板 标签 {% ur1l 
%} 〈 见 外) 。 这 行 让 Django 生 成 一 个 链接 ， 它 与 
learning_logs/urls.py 中 名 为 'topics" 的 URL 模 式 匹 配 。 


现在 如 果 刷 新 浏览 器 中 的 主页 ， 将 看 到 链接 Topics。 如 果 单 击 
这 个 链接 ， 将 看 到 类 似 于 图 18-4 所 示 的 页 面 。 


Oe@.K ® localhost:8000/topics/_ © © 


B 
Me 
+ 


Learning Log - Topics 


Topics 


e Chess 
e Rock Climbing 


图 18-4 显示 所 有 主题 的 页 面 
18.4.3 ”显示 特定 主题 的 页 面 


接 下 来 ， 需 要 创建 一 个 专注 于 特定 主题 的 页 面 ， 它 显示 该 主题 的 名 
称 以 及 所 有 和 条目。 我 们 同样 将 定义 一 个 新 的 URL 模 式 ， 编 写 一 个 视 
图 并 创建 一 个 模板 。 此 外 ， 还 将 修改 显示 所 有 主题 的 页 面 ， 让 每 个 
项 目 列表 项 都 变 为 到 相应 主题 页 面 的 链接 。 


a.，URL 模 式 


显示 特定 主题 的 页 面 的 URL 模 式 与 前 面 的 所 有 URL 模 式 都 稍 有 
不 同 ， 因 为 它 使 用 主题 的 id 属性 来 指出 请 求 的 是 哪个 主题 。 
例如 ， 如 果 用 户 要 查看 主题 Chess (其 id 为 1) 的 详细 页 面 ， 
URL 将 为 http://localhost:8000/topics/1/。 下 面 是 与 这 个 URL 史 配 
的 模式 ， 应 将 其 放 在 learning_logs/ urls.py 中 : 


urls.py 


--Snip-- 

urlpatterns = [ 
--Snip-- 
# 特定 主题 的 详细 页 面 。 


path('topics/<int:topic id>/', views.topic, name="'topic'), 


] 


我 们 来 详细 研究 这 个 URL 模 式 中 的 字符 

串 "topics/<int:topic_ id>/' 。 这 个 字符 串 的 第 一 部 分 让 
Django 碍 找 在 基础 UREL 后 包含 单词 topics 的 URL， 第 二 部 分 
(/<int:topic_id>/ ) 与 包含 在 两 个 和 糙 杠 内 的 整数 匹配 ， 并 
将 这 个 整数 存储 在 一 个 名 为 topic_id 的 实 参 中 。 


发 现 URL 与 这 个 模式 匹配 时 ，Django 将 调用 视图 函数 topic() 
， 并 将 存储 在 topic_id 中 的 值 作为 实 参 传递 给 它 。 在 这 个 函 
数 中 ， 将 使 用 topic_id 的 值 来 获取 相应 的 主题 。 


b. 视图 


函数 topic() 需要 从 数据 库 中 获取 指定 的 主题 以 及 与 之 相关 联 
的 所 有 条 目 ， 如 下 所 示 : 


views.py 


-snip- 

@ def topic(request, topic id): 

"显示 单个 主题 及 其 所 有 的 条 目 。 

topic = es objects. 2 topic id) 


entries = topic.entry_set.order by('-date added') 
context = {'topic': topic, "entries': entries} 
return render(request, 'learning logs/topic.html', context) 


这 是 除 request 对 象 外 ， 第 一 个 还 包含 男 一 个 形 参 的 视图 函 

数 。 这 个 函数 接受 表达 式 /<int:topic_id>/ 捕获 的 值 ， 并 将 
其 存储 到 topic_ id 中 ( 见 @)。 在 介 处 ， 使 用 get() 来 获取 
指定 的 主题 ， 就 像 前 面 在 Django shell 中 所 做 的 那样 。 在 全 处 ， 
获取 与 该 主题 相关 联 的 条 目 ， 并 根据 date_added 进行 排 

序 : date_added 前 面 的 减 号 指定 按 降 序 排 列 ， 即 先 显 示 最 近 
的 条 目 。 将 主题 和 条 目 都 存储 在 字典 context 中 ( 见 @) ， 再 
将 这 个 字典 发 送 给 模板 topic.html 〈 见 @@) 。 


注意 ”全 处 和 人 @ 处 的 代码 称 为 查询 ， 因 为 它们 辐 数 据 库 
查询 了 特定 的 信息 。 在 自己 的 项 目 中 编写 这 样 的 查询 时 ， 
先 在 Django shell 中 进行 尝试 大 有 神 益 。 比 起 先 编写 视图 和 
i 吉 果 ， 在 shell 中 执行 代码 可 更 快 
获得 反馈 


c， 模板 


这 个 模板 需要 显示 主题 的 名 称 和 条 目的 内 容 。 如 采 当 前 主题 不 
包含 任何 条 目 ， 还 需 疝 用 户 指 出 这 一 反 : 


topic.html 


{% extends 'learning logs/base.html' %} 
{% block content %} 
<p>Topic: {{ topic }}</p> 
<p>Entries:</p> 
<ul> 


{% for entry in entries %} 
<1i> 


<p>{{ entry.date added|date:'M d, Y H:i' }}</p> 
<p>{{ entry.text|linebreaks }}</p> 
</1i> 
{% empty %} 
<li>There are no entries for this topic yet.</1i> 
{% endfor %} 
</ul> 


{% endblock content %} 


像 这 个 项 目的 其 他 页 面 一 样 ， 这 里 也 继承 了 base.html。 接 下 
来 ， 显 示 当 前 的 主题 ( 见 @) ， 它 存储 在 模板 变量 {{ topic 
}} 中 。 为 什么 可 以 使 用 变量 topic 呢 ? 因为 它 包 含 在 字 

典 context 中 。 接 下 来 ， 定 义 一 个 显示 每 个 条 目的 项 目 列 表 
( 见 @) ， 并 像 前 面 显示 所 有 主题 一 样 人 遍历 条 目 ( 风 @@) 。 


每 个 项 目 列表 项 都 将 列 出 两 项 信息 : 条 目的 时 间 惟 和 完整 的 文 
本 。 为 列 出 时 间 惟 〈 见 四 ) ， 我 们 显示 属性 date_added 的 
值 。 在 Django 模 板 中 ， 竖 线 〈| ) 表示 模板 过 滤器 ， 即 对 模板 
变量 的 值 进行 修改 的 函数 。 过 滤器 date: 'M d，Y H:i' 以 类 
似 于 这 样 的 格式 显示 时 间 惟 : January 1, 2018 23:00。 接 下 来 的 
一 行 显 示 text 的 完整 值 ， 而 不 仅仅 是 前 50 字 符 。 过 波 

器 linebreaks 〈 见 人 加) 将 包含 换行 符 的 长 条 目 转换 为 浏览 器 
能 够 理解 的 格式 ， 以 免 显 示 为 不 间断 的 文本 块 。 在 @@ 处 ， 使 用 
模板 标签 {% empty %} 打印 一 条 消息 ， 告 诉 用 户 当 前 主题 还 
没有 条 目 。 


d. 将 显示 所 有 主题 的 页 面 中 的 主题 设置 为 链接 


在 浏览 右 中 碍 看 显示 特定 主题 的 页 面前 ， 需 要 修改 模板 
topics.html， 让 每 个 主题 者 链接 到 相应 的 页 面 ， 如 下 所 示 : 


topics.html 


--Snip-- 
{% for topic in topics %} 
<1i> 
<a href="{% url 'learning logs:topic' topic.id %}">{{ topi 
</1i> 


{% empty %} 
--Snip-- 


我 们 使 用 模板 标签 url 根据 learning_ logs 中 名 为 'topic' 
的 URL 模 式 生 成 了 合适 的 链接 。 这 个 URL 模 式 要 求 提 供 实 参 
topic id ， 因 此 在 模板 标签 url 中 添加 了 属性 topic.id 。 现 
在 ， 主 题 列 表 中 的 每 个 主题 都 是 链接 了 ， 链 接 到 显示 相应 主题 
的 页 面 ， 如 http://localhost:8000/ topics/1/。 


如 果 现 在 刷新 显示 所 有 主题 的 页 面 ， 再 单 击 其 中 的 一 个 主题 ， 
将 看 到 类 似 于 图 18-5 所 示 的 页 面 。 


® < 口 信 localhost:8000/topics/1/ , © 白 器 


Learning Log - Topics 


Topic: Chess 
Entries: 
e Feb 19,2019 02:06 


In the opening phase of the game,it's important to bring out your bishops and knights. These pieces are powerful and 
maneuverable enough to play a significant role in the beginning moves of a game. 


。 Feb 19,2019 02:06 


The opening is the first part of the game, roughly the first ten moves or s0. In the opening, it’s a good idea to do three 
things 一 bring out your bishops and knights, try to control the center of the board, and castle your king. 


Of course, these are just guidelines. It will be important to leam when to follow these guidelines and when to disregard 
these suggestions. 


图 18-5 ”特定 主题 的 详细 页 面 ， 其 中 显示 了 该 主题 的 所 有 条 


注意 topic.id 和 topic_ id 之 间 存 在 细微 而 重要 的 差别 。 表 
达 式 topic.id 检 查 主 题 并 获取 其 ID 值 ， 而 在 代码 中 ， 变 量 
topic_id 是 指 同 该 ID 的 引用 。 使 用 ID 时 如 果 出 现 错误 ， 请 
确保 正确 地 使 用 了 这 两 个 表达 式 。 


动手 试 一 斌 


练习 18-7: 模板 文档 ”请 浏览 Django 模 板 文档 。 自 己 开发 项 目 
时 ， 你 可 再 回 过 头 来 参考 该 文档 。 


练习 18-8: 比萨 店 页 面 “在 练习 18-6 中 开发 的 项 目 Pizzeria 

中 ， 添 加 一 个 页 面 来 显示 供应 的 比萨 的 名 称 。 然 后 ， 将 每 个 比 
萨 名 都 设置 成 链接 ， 可 通过 单 击 来 显示 一 个 列 出 相应 配料 的 页 
面 。 请 务必 使 用 模板 继承 来 高 效 地 创建 页 面 。 


18.5 小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 Django 框 以 来 创建 web 应 用 程序 ; 
制定 简要 的 项 目 规范 ， 在 虚拟 环境 中 安装 Django， 创 建 一 个 项 目 ， 
并 核实 该 项 目 已 被 正确 地 创建 ;如何 创建 应 用 程序 ， 以 及 如 何 定义 
表示 应 用 程序 数据 的 模型 。 你 了 解 了 数据 库 ， 以 及 在 修改 模型 后 ， 
Django 可 为 迁移 数据 库 提 供 什么 帮助 。 你 创建 了 可 访问 管理 网 站 的 
超级 用 户 ， 并 使 用 管理 网 站 输入 了 一 些 初 始 数据 。 


你 还 探索 了 Django shell， 它 让 你 能 够 在 终端 会 话 中 处 理 项 目的 数 

据 。 你 学 习 了 如 何 定 义 URL、 创 建 视图 函数 以 及 编写 为 网 站 创建 页 
面 的 模板 。 最 后 ， 你 使 用 模板 继承 简化 了 各 个 模板 的 结构 ， 使 修改 
网 站 变 得 更 容易 。 


第 19 章 将 创建 对 用 户 友 好 而 直观 的 页 面 ， 让 用 户 无 须 通过 管理 网 站 
就 能 添加 新 的 主题 和 条 目 ， 以 及 编辑 妹 有 条 目 。 我 们 还 将 添加 一 个 
用 户 注册 系统 ， 让 用 户 能 够 创建 账户 并 记录 上 自己 的 学 习 笔 记 。Web 
应 用 程序 的 核心 就 是 ， 让 任意 数量 的 用 户 都 能 与 之 交互。 


第 19 章 用 户 账户 


Web 应 用 程序 的 核心 是 让 任何 用 户 都 能 够 注册 账 
户 并 能 够 使 用 它 ， 不 管用 户 吴 处 何方 。 在 本 章 中 ， 我 们 将 创建 
一 些 表单 ， 让 用 户 能 够 添加 主题 和 条 目 ， 以 及 编辑 既 有 的 条 
目 。 我 们 还 将 学 习 Django 如 何 防 范 对 基于 表单 的 页 面 发 起 的 党 
见 攻击 ， 从 而 无 须 花 太 多 时 间 考 虑 确保 应 用 程序 安全 的 问题 。 


然后 ， 我 们 将 实现 一 个 用 户 喘 份 验证 系统 。 首 先 创建 一 个 注册 页 
面 ， 供 用 户 创建 账户 ， 并 让 有 些 页 面 只 能 供 已 登录 的 用 户 访 问 。 接 
下 来 ， 修 改 一 些 视图 函数 ， 使 得 用 户 只 能 看 到 自己 的 数据 。 我 们 还 
将 学 习 如 何 确保 用 户 数据 的 安全 。 


19.1 让 用 户 输入 数据 


建立 用 于 创建 用 户 账户 的 喘 份 验证 系统 之 前 ， 我 们 先 来 添加 几 个 页 
面 ， 让 用 户 能 够 输入 数据 。 我 们 将 让 用 户 添加 新 主题 添加 新 条 目 
以 及 编辑 既 有 条 目 。 


当前 ， 只 有 超级 用 户 能 够 通过 管理 网 站 输入 数据 。 我 们 不 想 让 用 户 
与 管理 网 站 交互 ， 因 此 我 们 将 使 用 Django 的 表单 创建 工具 来 创建 让 
用 户 能 够 输入 数据 的 页 面 。 


19.1.1 添加 新 主题 


首先 来 让 用 户 能 够 添加 新 主题 。 创 建 基于 表单 的 页 面 的 方法 几乎 与 
前 面 创建 页 面 一 样 : 定义 URL， 编 写 视图 函数 并 编写 一 个 模板 。 一 
个 主要 差别 是 ， 需 要 导入 包含 表单 的 模块 forms.py。 


a， 用 于 添加 主题 的 表单 


让 用 户 输入 并 提交 信息 的 页 面 都 是 表单 ， 那 怕 看 起 来 不 像 。 用 
户 输入 信息 时 ， 我 们 需要 进行 验证 ， 确 认 提 供 的 信息 是 正确 的 
数据 类 型 ， 而 不 是 恶意 的 信息 ， 如 中 断 服务 器 的 代码 。 然 后 ， 
对 这 些 有 效 信息 进行 处 理 ， 并 将 其 保存 到 数据 库 的 合适 地 方 。 
这 些 工 作 很 多 都 是 由 Django 目 动 完 成 的 。 


在 Diango 中 ， 创 建 表单 的 最 简单 方式 是 使 用 ModelForm ， 它 根 
据 我 们 在 第 18 间 定义 的 模型 中 的 信息 自动 创建 表单 。 请 创建 一 
个 名 为 forms.py 的 文件 ， 将 其 存储 到 models.py 所 在 的 目录 ， 并 
在 其 中 编写 你 的 第 一 个 表单 : 


forms.py 


from django import forms 


from .models import Topic 


@ class TopicForm(forms.ModelForm): 
class Meta: 
@ model = Topic 


© fields 
@ labels 


['text'] 
{'text': ''} 


首先 导入 模块 forms 以 及 要 使 用 的 模型 Topic 。 在 @ 处 ， 定 义 
一 个 名 为 TopicForm 的 类 ， 它 继承 了 forms .ModelForm 。 


最 简单 的 ModelForm 版 本 只 包含 一 个 内 藤 的 Meta 类 ， 让 
Django 根 据 哪个 模型 创建 表单 以 及 在 表单 中 包含 哪些 字段 。 在 
全 处 ， 根 据 模 型 Topic 创建 表单 ， 其 中 只 包含 字段 text ( 见 
合 ) .四 处 的 代码 让 Django 不 要 为 字段 text 生成 标签 。 


. URL 模式 new_topic 


新 页 面 的 URL 应 简短 且 上 共有 描述 性 ， 因 此 当 用 户 要 添加 新 主题 
时 ， 我 们 切换 到 http://localhost:8000/new_topic/。 下 面 是 页 

面 new_topic 的 URL 模 式 ， 请 将 其 添加 到 learning_logs/ urls.py 
中 : 


urls.py 


--Snip-- 
urlpatterns = [ 
--Snip-- 
# 用 于 添加 新 主题 的 页 面 。 


path('new topic/', views.new topic, name='new topic'), 


这 个 URL 模 式 将 请 求 交 给 视图 函数 new_topic() ， 下 面 来 编 
写 这 个 函数 。 
.视图 函数 new_topic() 


函数 new_topic() 需要 处 理 两 种 情形 。 一 是 刚 进 
入 new_topic 页 面 《 在 这 种 情况 下 应 显示 空 表单 ) ; 二 是 对 提 


交 的 表单 数据 进行 处 理 ， 并 将 用 户 重 定 问 到 页 面 topics : 


views.py 


from django.shortcuts import render, redirect 


from .models import Topic 
from .forms import TopicForm 


--Snip-- 
def new topic(request): 
""" 添 加 新 主题 。""" 
if request .method != "POST ': 
# 未 提交 数据 : 创建 一 个 新 表单 。 
form = TopicForm() 
else: 
# POST 提交 的 数据 : 对 数据 进行 处 理 。 
form = TopicForm(data=request.POST) 
if form.is valid(): 
form.save() 
Peturn redirect('learning logs:topics') 


# 显示 空 表单 或 指出 表单 数据 无 效 。 
context = { ' form': form} 
return render(request, 'learning logs/new topic.html', cont 


我 们 导入 了 函数 redirect ， 用 户 提 交 主 题 后 将 使 用 这 个 函数 
重 定向 到 页 面 topics 。 函 数 redirect 将 视图 名 作为 参数 ， 并 
将 用 户 重 定 同 到 这 个 视图 。 我 们 还 导入 了 刚 创 建 的 表 

单 TopicForm 。 


. GET 请 求 和 POST 人 请求 


创建 Web 应 用 程序 时 ， 将 用 到 的 两 种 主要 请 求 类 型 是 GET 请 求 
和 POST 请 求 。 对 于 只 是 从 服务 器 读 取 数据 的 页 面 ， 使 用 GET 
请 求 ， 在 用 户 需 要 通过 表单 提交 信息 时 ， 通 常 使 用 POST 请 
求 。 处 理 所 有 表单 时 ， 都 将 指定 使 用 POST 方法 。 还 有 一 些 其 
他 类 型 的 请 求 ， 但 本 项 目 没 有 使 用 。 


函数 new_topic() 将 请 求 对 象 作 为 参数 。 用 户 初 次 请 求 该 页 

面 时 ， 其 浏览 器 将 发 送 GET 请 求 ， 用 户 填 写 并 提交 表单 时 ， 其 
浏览 器 将 发 送 POST 请 求 。 根 据 请 求 的 类 型 ， 可 确定 用 户 请 求 
的 是 空 表单 〈GET 请 求 ) 还 是 要 求 对 填写 好 的 表单 进行 处 理 

(POST 请 求 ) 。 


加 处 的 测试 确定 请 求 方法 是 GET 还 是 POST。 如 果 请 求 方法 不 
是 POST， 请 求 就 可 能 是 GET， 因 此 需要 返回 一 个 空 表 单 。 
《即便 请 求 是 其 他 类 型 的 ， 返 回 空 表单 也 不 会 有 任何 问题 。) 
全 处 创建 一 个 TopicForm 实例 ， 将 其 赋 给 变量 form ， 再 通过 
上 下 文字 上 典 将 这 个 表单 发 送 给 模板 ( 见 @) 。 由 于 实例 

化 TopicForm 时 没有 指定 任何 实 参 ，Django 将 创建 一 个 空 表 
单 ， 供 用 户 填写 。 


如 果 请 求 方法 为 POST， 将 执行 else 代码 块 ， 对 提交 的 表单 数 
据 进 行 处 理 。 我 们 使 用 用 户 输入 的 数据 (存储 

在 request.POST 中 ) 创建 一 个 TopicForm 实例 ( 见 @) ， 这 
样 对 象 form 将 包含 用 户 提交 的 信息 。 


要 将 提交 的 信息 保存 到 数据 库 ， 必 须 先 通过 检查 确定 它们 是 有 
效 的 〈 见 加) .方法 is_valid() 核实 用 户 填 写 了 所 有 必 不 可 
少 的 字段 (表单 字段 默认 都 是 必 不 可 少 的 ) ， 且 输入 的 数据 与 
要 求 的 字段 类 型 一 致 〈 例 如 ， 字 段 text 少 于 200 字 符 ， 这 是 第 
18 章 在 models.py 中 指定 的 ) 。 这 种 自动 验证 避免 了 我 们 去 做 大 
量 的 工作 。 如 果 所 有 字段 都 有 效 ， 就 可 调用 save() 〈 见 

加 ) ， 将 表单 中 的 数据 写 入 数据 库 。 


保存 数据 后 ， 就 可 离开 这 个 页 面 了 。 为 此 ， 使 用 redirect() 
将 用 户 的 浏览 器 重 定向 到 页 面 topics ( 见 @) 。 在 页 
面 topics 中 ， 用 户 将 在 主题 列表 中 看 到 他 刚 输入 的 主题 。 


我 们 在 这 个 视图 函数 的 末尾 定义 了 变量 context ， 并 使 用 稍 后 
将 创建 的 模板 new_topic.html 来 演 染 页 面 。 这 些 代码 不 在 if 代 
人 码 块 内 ， 因 此 无 论 是 用 户 刚 进入 new_topic 页 面 还 是 提交 的 表 
单数 据 无 效 ， 这 些 代 码 都 将 执行 。 用 户 提 交 的 表单 数据 无 效 
时 ， 将 显示 一 些 默认 的 错误 消息 ， 帮 助 用 户 提 供 有 效 的 数据 。 


e. 模板 new_topic 
下 面 来 创建 新 模板 new_topic.html， 用 于 显示 刚 创建 的 表单 : 


new_topic.html 


{% extends "learning logs/base.html" %} 


{% block content %} 
<p>Add a new topic:</p> 


<form action="{% url 'learning logs:new topic' %}" method='po 
{% csrf _ token %} 
{{ form.as _p }} 
<button name="submit">Add topic</button> 

</form> 


{% endblock content %} 


这 个 模板 继承 了 base.html， 因 此 其 基本 结构 与 项 目 “ 学 习 笔 
记 ” 的 其 他 页 面相 同 。 在 @ 处 ， 定 义 了 一 个 HTML 表 单 。 实 参 
action 告诉 服务 右 将 提交 的 表单 数据 发 送 到 哪里 。 这 里 将 它 
发 回 给 视图 函数 new_topic() 。 实 参 method 让 浏览 器 以 
POST 请 求 的 方式 提交 数据 。 


Django 使 用 模板 标签 {% csrf_token %} 《〈 见 四 ) 来 防止 攻击 

者 利用 表单 来 获得 对 服务 器 未 经 授权 的 访问 (这 种 攻击 称 为 跨 

站 请 求 伪 造 ) 。 全 处 显示 表单 ， 从 中 可 知 Django 使 得 完成 显 

示 表 单 等 任务 有 多 简单 : 只 需 包 售 模 板 变 量 {{ form.as_p 

}}， i Oa 修饰 

侍 as _p 让 Django 以 段落 格式 演 染 所 有 表单 元 素 ， 这 是 一 种 整 
洁 地 显示 表单 的 简单 方式 。 


Dijango 个 会 为 表征 创建 提交 按钮， 因此 我 们 在 人 处 定义 了 一 
人 


f 链接 到 页 面 new_topic 


下 面 在 页 面 topics 中 添加 到 页 面 new_topic 的 链接 : 
topics.html 


{% extends "learning logs/base.html" %} 
{% block content %} 

<p>Topics</p> 

<ul> 


--Snip-- 
</ul> 


<a href="{% url 'learning logs:new topic' %}">Add a new topic</ 


{% endblock content %} 


这 个 链接 放 在 既 有 主题 列表 的 后 面 。 图 19-1 显 示 了 生成 的 表 
单 。 请 使 用 这 个 表单 来 添加 几 个 新 主题 。 


Oo@e@ K locahostao00newitopie] CO @ 几 DC 用 
Learning Log - Topics 


Add a new topic: 


Add topic 


图 19-1 用 于 添加 新 主题 的 页 面 
19.1.2 ”添加 新 条 目 
可 以 添加 新 主题 之 后 ， 用 户 还 会 想 添加 几 个 新 条 目 。 我 们 将 再 


次 定义 URL， 编 写 视 图 函数 和 模板 ， 并 且 链 接 到 添加 新 条 目的 
页 面 。 但 在 此 之 前 ， 需 要 在 forms.py 中 再 添加 一 个 类 。 


i， 用 于 添加 新 条 目的 表单 


我 们 需要 创建 一 个 与 模型 Entry 相关 联 的 表单 ， 但 这 个 表 
单 的 定制 程度 比 TopicForm 更 高 一 些 : 


forms.py 


from django import forms 
from .models import Topic, Entry 


class TopicForm(forms.ModelForm): 
--Snip-- 


class EntryForm(forms.ModelForm): 
class Meta: 
model = Entry 
fields ['text'] 
labels {'text': " '} 
widgets = {'text': forms.Textarea(attrs={'cols': 8( 


首先 修改 import 语句 ， 使 其 除 导 入 Topic 外 ， 还 导 

入 Entry 。 新 类 EntryForm 继承 了 forms .ModelForm， 

它 包含 的 Meta 类 指出 了 表单 基于 的 模型 以 及 要 在 表单 中 

包含 哪些 字段 。 这 里 给 字段 'text' 指定 了 标签 'Entry:' 
( 见 @) . 


在 全 处 ， 我 们 定义 了 属性 widgets 。 小 部 件 (widget) 是 
一 个 HTML 表 单元 素 ， 如 单行 文本 框 、 多 行文 本 区 域 或 下 
拉 列 表 。 通 过 设置 属性 widgets ， 可 覆盖 Django 选 择 的 默 
认 小 部 件 。 通 过 让 Django 使 用 forms .Textarea ， 我 们 定 
制 了 字段 'text' 的 输入 小 部 件 ， 将 文本 区 域 的 宽度 设置 
为 80 列 ， 而 不 是 默认 的 40 列 。 这 给 用 户 提供 了 足够 的 空间 
来 编写 有 意义 的 条 目 。 


ii. 


iii. 


URL 模 式 new_entry 


在 用 于 添加 新 条 目的 页 面 的 URL 模 式 中 ， 需 要 包含 实 参 
topic_ id ， 因 为 条 目 必须 与 特定 的 主题 相关 联 。 该 URL 
模式 如 下 ， 请 将 它 添 加 到 learning_logsmurls.py 中 : 


urls.py 


--Snip-- 
urlpatterns = [ 
--Snip-- 


# 用 于 添加 新 条 目的 页 面 。 


path('new entry/<int:topic id>/', views.new entry, name= 


这 个 URL 模 式 与 形 如 
http://localhost:8666/new_entry/id / 的 URL 匹 
配 ， 其 中 的 id 是 一 个 与 主题 ID 匹配 的 数 。 代 

人 码 <int:topic_idy> 捕获 一 个 数值 ， 并 将 其 赋 给 变量 
topic_id 。 请 求 的 URL 与 这 个 模式 匹配 时 ，Django 将 请 
求 和 主题 ID 发 送 给 函数 new_entry() 。 


视图 函数 new_entry() 


视图 疯 数 new_entry() 与 函数 new_topic() 很 像 ， 请 在 
views.py 中 添加 如 下 代码 : 


views.py 


from django.shortcuts import render, redirect 


from .models import Topic 
from .forms import TopicForm, EntryForm 


--Snip-- 
def new_entry(request，topic_ id) : 
""" 在 特定 主题 中 添加 新 条 目 。""" 
@ topic = Topic.objects.get(id=topic id) 


@ if request .method != "POST ': 
# 未 提交 数据 : 创建 一 个 空 表单 。 


3 form = EntryForm() 
else: 

# POST 提交 的 数据 : 对 数据 进行 处 理 。 
@ form = EntryForm(data=request.POST) 

if form.is valid(): 
9 new_entry = form.save(commit=False) 
9 new_entry .topic = topic 

new_entry .save() 

@ return redirect('learning logs:topic', topic i 


# 显示 空 表单 或 指出 表单 数据 无 效 。 
context = {'topic': topic, 'form': form} 
return render(request, 'learning logs/new entry.html', 


我 们 修改 import 语句 ， 在 其 中 包含 刚 创 建 的 EntryForm 
。new_entry() 的 定义 包含 形 参 topic_id ， 用 于 存储 从 
URL 中 获得 的 值 。 泻 染 页 面 和 处 理 表 单数 据 时 ， 都 需要 知 


道 针对 的 古 哪个 主题 ， 因 此 使 用 topic_id 来 获得 正确 的 
主题 ( 见 @) ， 


在 @ 处 ， 检 查 请 求 方法 是 POST 还 是 GET。 如 果 是 GET 请 
求 ， 束 执行 if 代码 块 ， 创 建 一 个 空 的 EntryForm 实例 

( 见 @) 。 如 果 请 求 方法 为 POST， 就 对 数据 进行 处 理 : 
创建 一 个 EntryForm 实例 ， 使 用 request 对 象 中 的 POST 
数据 来 填充 它 〈 见 仆 ) 。 然 后 检查 表单 是 否 有 效 。 如 果 有 
0 目 对 象 的 属性 topic ， 再 将 条 目 对 象 保 存 到 


调用 save() 时 ， 传 递 实 参 commit=False ( 见 @) ， 让 
Django 创 建 一 个 新 的 条 目 对 象 ， 并 将 其 赋 给 new_entry ， 
但 不 保存 到 数据 库 中 。 将 new_entry 的 属性 topic 设置 为 
在 这 个 函数 开头 从 数据 库 中 获取 的 主题 ( 见 @) ， 再 调 
用 save() 旦 不 指定 任何 实 参 。 这 将 把 条 目 保存 到 数据 
库 ， 并 将 其 与 正确 的 主题 相关 联 。 


在 @ 处 ， 调 用 redirect() ， 它 要 求 提供 两 个 参数 ， 要 重 


定向 到 的 视图 和 要 给 视图 函数 提供 的 参数 。 这 里 重 定向 
到 topic() ， 而 这 个 视图 函数 需要 参数 topic_id 。 视 图 
函数 topic() 泻 染 新 增 条 目 所 属 主题 的 页 面 ， 其 中 的 条 目 
列表 包含 新 增 的 条 目 。 


在 视图 函数 new_entry() 的 末尾 ， 我 们 创建 了 一 个 上 下 
文字 典 ， 并 使 用 模板 new_entry.html 演 染 页 面 。 这 些 代码 
将 在 用 户 刚 进入 页 面 或 提交 的 表单 数据 无 效 时 执行 。 


. 模板 new_entry 


ey 类 似 于 模板 new_topic ， 如 下 面 的 代码 
小: 


new_entry.html 


{% extends "learning logs/base.html" %} 


{% block content %} 


@ “《p><a href="{% url 'learning logs:topic' topic.id %}">{{ 


<p>Add a new entry:</p> 
@ <form action="{% url "learning_ logs:new entry' topic.id 7 
{% csrf _ token %} 
{{ form.as _p }} 
<button name="'submit"'>Add entry</button> 
</form> 


{% endblock content %} 


在 页 面 顶 端 显示 主题 ( 见 @) ， 让 用 户 知道 自己 是 在 哪个 
主题 中 添加 条 目 。 该 主题 名 也 是 一 个 链接 ， 可 用 于 返回 到 
该 主题 的 主页 面 。 


表单 的 实 参 action 包含 URL 中 的 topic_id 值 ， 让 视图 函 
数 能 够 将 新 条 目 关联 到 正确 的 主题 〈 见 鳞 ) 。 除 此 之 外 ， 
这 个 模板 与 模板 new_topic.html 完 全 相同 。 


v. 链接 到 页 面 new_entry 


接 下 来 ， 需 要 在 显示 特定 主题 的 页 面 中 添加 到 页 
面 new_entry 的 链接 : 


topic.html 


{% extends "learning logs/base.html" %} 


{% block content %} 
<p>Topic: {{ topic }}</p> 


<p>Entries:</p> 
<p> 
<a href="{% url 'learning logs:new entry' topic.id %}">Ad 
</p> 
<ul> 
--Snip-- 


</U1L> 


{% endblock content %} 


我 们 将 这 个 链接 放 在 条 目 列表 前 面 ， 因 为 在 这 种 页 面 中 ， 
执行 的 最 常见 的 操作 是 添加 新 条 目 。 图 19-2 显 示 了 页 

面 new_entry 。 现 在 用 户 可 添加 新 主题 ， 还 可 在 每 个 主题 
中 添加 任意 数量 的 条 目 。 请 在 一 些 主 题 中 添加 新 条 目 ， 尝 
试 使 用 一 下 页 面 new_entry 。 


@ DB < 6 localhost:8000/new_entry/1/ © 由 5 


Learning Log - Topics 


Chess 


Add a new entry: 


The bishops and knights are g 
powerful enough to be usefu 
them in an early trade. 


ood pieces to have out in the opening phase of the game. They're both 
| in attacking your opponent, but not so powerful that you can't afford to 


lose 


Add entry 


图 19-2 页 面 new_entry 


19.1.3 ”编辑 条 目 
下 面 来 创建 让 用 户 能 够 编辑 既 有 条 目的 页 面 。 


Qa. URL 模 式 edit_entry 


这 个 页 面 的 URL 需 要 传递 要 编辑 的 条 目的 ID。 修 改 后 
的 learning_logs/urls.py 如 下 : 


urls.py 


--Snip-- 
urlpatterns = [ 
--Snip-- 


# 用 于 编辑 条 目的 页 面 。 


path( "edit_entry/<int:entry_ id>/', views.edit entry 


在 URL (如 http://localhost:8000/edit_entry/1/〉 中 传递 
的 JD 存储 在 形 参 entry_id 中 。 这 个 URL 模 式 将 与 其 
匹配 的 请 求 发 送 给 视图 函数 edit_entry() 。 


B. 视图 函数 edit_entry() 


页 面 edit_entry 收 到 GET 请 求 时 ，edit_entry() 

将 返回 一 个 表单 ， 让 用 户 能 够 对 条 目 进 行 编辑 ， 收 到 
POST 请 求 〈 条 目 文本 经 过 修订 ) 时 ， 则 将 修改 后 的 

文本 保存 到 数据 库 : 


views.py 


from django.shortcuts import render, redirect 


from .models import Topic, Entry 
from .forms import TopicForm, EntryForm 
--Snip-- 


def edit _entry(reduest， entry_id): 
'" 编 辑 既 有 条 目 。 
entry = Entry.objects.get(id=entry_ id) 
topic = entry.topic 


if request.method != 'POST' 
# 初次 请 求 : 使 用 当 前 条 目 填 充 表 单 ， 
form = EntryForm(instance=entry) 
else: 
# POST 提 交 的 数据 : 对 数据 进行 处 理 。 
form = EntryForm(instance=entry, data=request 
if form.is valid(): 
form.save() 
return redirect('learning logs:topic', to 


context = {'entry': entry, 'topic': topic, 'form' 
return render(request, 'learning logs/edit entry. 


首先 导入 模型 Entry 。 在 @ 处 ， 获取 用 户 要 修改 的 条 
目 对 象 以 及 与 其 相关 联 的 主题 。 在 请 求 方法 为 GET 时 
将 执行 的 if 代码 块 中 ， 使 用 实 参 instance-entry 
创建 一 个 EntryForm 实例 ( 见 @) 。 这 个 实 参 让 
Django 创 建 一 个 表单 ， 并 使 用 既 有 条 目 对 象 中 的 信息 
填充 它 。 用 户 将 看 到 既 有 的 数据 ， 并 且 能 够 编辑 。 


处 理 POST 请 求 时 ， 传 递 实 参 instance=entry 和 


data=request.POST ( 见 @) ， 让 Django 根 据 既 有 
条 目 对 象 创 建 一 个 表单 实例 ， 并 根据 request .POST 
中 的 相关 数据 对 其 进行 修改 。 然 后 ， 检 查 表单 是 否 有 
效 。 如 果 有 效 ， 就 调用 save() 且 不 指定 任何 实 参 

( 见 @) ， 因 为 条 目 己 关联 到 特定 的 主题 。 然 后 ， 重 
定 问 到 显示 条 目 所 属 主题 的 页 面 ( 见 @) ， 用 户 将 在 
其 中 看 到 其 编辑 的 条 目的 新 版 本 。 


如 果 要 显示 表单 让 用 户 编 辑 条 目 或 者 用 户 提 交 的 表单 
无 效 ， 就 创建 上 下 文字 典 并 使 用 模板 edit_entry.html 泻 
染 页 面 。 


.模板 edit_entry 


下 面 来 创建 模板 edit_entry.html， 它 与 模板 


new_entry.html 类 似 : 
edit_entry.html 
{% extends "learning logs/base.html" %} 
{% block content %} 
<p><a href="{% url 'learning logs:topic' topic.id % 


<p>Edit entry:</p> 


@ <form action="{% Url 'learning logs:edit entry' ent 
{% csrf _ token %} 
{{ form.as _p }} 
<button name="submit">Save changes</buttony> 
</form> 


{% endblock content %} 


在 @ 处 ， 实 参 action 将 表单 发 送 给 函 
数 edit_entry() 处 理 。 在 标签 {% url %} 中 ， 将 条 
目 ID 作 为 一 个 实 参 ， 让 视图 函数 edit_entry() 能 够 


修改 正确 的 条 目 对 象 。 在 灸 处 ， 将 提交 按钮 的 标签 
置 成 Save changes， 骨 在 提醒 用 户 : 
存 所 做 的 编辑 ， 而 不 是 创建 一 个 新 条 目 。 


. 链接 到 页 面 edit_entry 


现在 ， 需 要 在 显示 特定 主题 的 页 面 中 给 每 个 条 目 添加 
到 页 面 edit_entry 的 链接 : 


topic.html 


--Snip-- 
{% for entry in entries %} 
<1i> 
<p>{{ entry.date added|date:'M d, Y H:i' }}</p> 
<p>{{ entry.text|linebreaks }}</p> 
<p> 


<a href="{% url 'learning logs:edit entry' entr 
</p> 
</1i> 
--Snip-- 


将 编辑 链接 放 在 了 每 个 条 目的 日 期 和 文本 后 面 。 在 循 

环 中 ， 使 用 模板 标签 人 url %} 根据 URL 模 

式 edit_entry 和 当前 条 目的 ID 属性 Centry.id ) 

| 链接 文本 为 Edit entry， 它 出 现在 页 < 面 中 
个 条 目的 后 面 。 图 19-3 显 示 了 包含 这 些 链 接 时 ， 显 

示 特 定 主题 的 页 面 是 什么 样 的 。 


名 < 口 © localhost:8000/topics/1/ © [#2 个 器 十 


Learning Log - Topics 


Topic: Chess 
Entries: 


Add new entry 


e Feb 19,2019 07:07 


The bishops and knights are good pieces to have out in the opening phase of the game. They're both powerful 
enough to be useful in attacking your opponent, but not so Powerful that you can't afford to lose them in an 
early trade. 


Edit entry 
e Feb 19,2019 02:06 


In the opening phase of the game,it's important to bring out your bishops and knights. These pieces are 
powerful and maneuverable enough to play a significant role in the beginning moves of a game. 


Edit entry 
e Feb 19, 2019 02:06 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it’s a good idea to 
do three things 一 bring out your bishops and knights, try to control the center of the board, and castle your 


图 19-3 每 个 条 目 都 有 一 个 用 于 编辑 的 链接 


至 此 ,“ 学 习 笔记 ”已 其 备 了 需要 的 大 部 分 功能 。 用 户 
可 添加 主题 和 条 目 ， 还 可 根据 需要 但 看 任何 条 目 。 在 
下 一 市 ， 我 们 将 实现 一 个 用 户 注 册 系 统 ， 让 任何 人 都 
可 同 “ 学 习 笔 记 ” 申 请 账户 ， 并 创建 自己 的 主题 和 条 
aE 


动手 试 一 试 


练习 19-1: 博客 ”新建 一 个 Django 项 目 ， 将 其 命名 为 
Blog。 在 这 个 项 目 中 ， 创 建 一 个 名 为 blogs 的 应 用 程 
序 ， 并 在 其 中 创建 一 个 名 为 BlogPost 的 模型 。 这 个 
模型 应 包含 title 、text 和 date_added 等 字段 。 为 
这 个 项 目 创建 一 个 超级 用 户 ， 并 使 用 管理 网 站 创建 几 
个 简短 的 帖子 。 创 建 一 个 主页 ， 在 其 中 按时 间 顺 序 显 
示 所 有 的 帖子 。 


创建 两 个 表单 ， 其 中 一 个 用 于 发 布 新 帖子 ， 为 一 个 用 
于 编辑 既 有 的 帖子 。 答 试 填写 这 些 表单 ， 确 认 它 们 能 
够 正确 工作 。 


19.2 创建 用 户 账户 


本 节 将 建 并 用 户 注 册 和 里 份 验证 系统 ， 让 用 户 能 够 注册 账 
户 ， 进 而 登录 和 注销 。 为 此 ， 我 们 将 新 建 一 个 应 用 程序 ， 
其 中 包含 与 处 理 用 户 账户 相关 的 所 有 功能 。 这 个 应 用 程序 
将 尽 可 能 使 用 Django 自 带 的 用 户 映 份 验证 系统 来 完成 工 

作 。 本 市 还 将 对 模型 Topic 稍 做 修改 ， 让 每 个 主题 都 归属 
于 特定 用 户 。 


19.2.1 应 用 程序 users 


首先 使 用 命令 startapp 创建 一 个 名 为 users 的 应 用 程 
序 : 


(11_env)learning log$ python manage.py startapp users 
(11_env)learning log$ 1s 
@ db.sqlite3 learning log learning logs 11_env manage.py use 


(11_env)learning log$ ls users 
@ _init .py admin.py apps.py migrations models.py tests.py 


这 个 命令 新 建 一 个 名 为 users 的 目录 ( 见 @) ， 其 结构 与 应 
用 程序 learning_logs 相同 ( 见 @) 。 


19.2.2 ”将 users 添加 到 settings.py 中 


在 settings.py 中 ， 需 要 将 这 个 新 的 应 用 程序 添加 
到 INSTALLED_APPS 中 ， 如 下 所 示 : 


settings.py 


--Snip-- 

INSTALLED_APPS = [ 
# 我 的 应 用 程序 
"learning logs', 
'Users', 


# DJjango 默 认 创 建 的 应 用 程序 


--Snip-- 


] 


--Snip-- 


这 样 ，Django 将 把 应 用 程序 users 包含 到 项 目 中 。 
19.2.3 包含 users 的 URL 


接 下 来 ， 需 要 修改 项 目 根 目录 中 的 urls.py， 使 其 包含 将 为 
应 用 程序 users 定义 的 URL: 


urls.py 


from django.contrib import admin 
from django.urls import path, include 


urlpatterns = [ 
path('admin/', admin.site.urls), 
path('users/', include('users.urls')), 
path('', include('learning logs.urls')), 


我 们 添加 了 一 行 代码 ， 以 包含 应 用 程序 users 中 的 文件 
urls.py。 这 行 代码 与 任何 以 单词 users 打 头 的 URL (如 
http://localhost:8000/users/login/〉 都 匹配 。 


19.2.4 登录 页 面 
首先 来 实现 登录 页 面 。 我 们 将 使 用 Django 提 供 的 默认 视图 
login ， 因 此 这 个 应 用 程序 的 URL 模 式 稍 有 不 同 。 在 目录 
learning_log/users/ 中 ， 新 建 一 个 名 为 urls.py 的 文件 ， 并 在 
其 中 添加 如 下 代码 : 


urls.py 


"" "为 应 用 程序 users 定 义 URL 模 式 。""" 


from django.urls import path, include 


@ app_name = 'Users' 
urlpatterns = [ 
# 包含 默认 的 身份 验证 URL。 
@ path('', include('django.contrib.auth.urls')), 


导入 函数 path 和 include ， 以 便 包 含 Django 定 义 的 一 些 
默认 的 吴 份 验证 URL。 这 些 默认 的 URL 包 含 具 名 的 URL 模 
式 ， 如 'login' 和 'logout' 。 我 们 将 变量 app_name 设 
置 成 'users' ， 让 Django 能 够 将 这 些 URL 与 其 他 应 用 程序 
的 URL 区 分 开 来 ( 见 @)。 即 便 是 Django 提 供 的 默认 
URL， 将 其 包含 在 应 用 程序 users 的 文件 中 后 ， 也 可 通过 
命名 空间 users 进行 访问 。 


登录 页 面 的 URL 模 式 与 URL 
http:Wlocalhost:8000/muserslogin/ 匹 配 〈 见 贸 ) 。 这 个 URL 
中 的 单词 users 让 Django 在 users/urls.py 中 查找 ， 而 单词 login 
让 它 将 请 求 发 送 给 Django 的 默认 视图 login 。 


a. 模板 login.html 


用 户 请 求 登 录 页 面 时 ，Django 将 使 用 一 个 默认 的 视图 
函数 ， 但 我 们 依然 需要 为 这 个 页 面 提供 模板 。 默 认 的 
身份 验证 视图 在 文件 来 registration 中 查找 模板 ， 因 此 
我 们 需要 创建 这 个 文件 来。 为 此 ， 在 目录 
learning_log/users/ 中 新 建 一 个 名 为 templates 的 目录 ， 
再 在 这 个 目录 中 新 建 一 个 名 为 registration 的 目录 。 下 
面 是 模板 login.html， 应 将 其 存储 到 目录 


learning_ log/users/templates/ registration 中 : 


login.html 


{% extends "learning logs/base.html" %} 


{% block content %} 


@ {% if form.errors %} 
<p>Your username and password didn't match. Pleas 
{% endif %} 


@ <form method="post" action="{% Url 'users:login' %} 
{% csrf _ token %} 


@ {{ form.as _p }} 
0 <button name="submit">Log in</button> 
9 <input type="hidden" name="next" 
value="{% url 'learning logs:index' %}" /> 
</form> 


{% endblock content %} 


这 个 模板 继承 了 base.html， 则 在 确保 登录 页 面 的 外 观 
与 网 站 的 其 他 页 面相 同 。 请 注意 ， 一 个 应 用 程序 中 的 
模板 可 继承 男 一 个 应 用 程序 中 的 模板 。 


如 果 设 置 表单 的 errors 属性 ， 就 显示 一 条 错误 消息 
( 见 @) ， 指 出 输入 的 用 户 名 密码 对 与 数据 库 中 存储 
的 任何 用 户 名 密码 对 都 不 匹配 。 


我 们 要 让 登录 视图 对 表单 进行 处 理 ， 因 此 将 实 参 
action 设置 为 登录 页 面 的 URL ( 见 @) 。 登 录 视 图 
将 一 个 表单 发 送 给 模板 。 在 模板 中 ， 我 们 显示 这 个 表 
单 ( 见 全 @) 并 添加 一 个 提交 按钮 〈 见 四 ) 。 在 加 处 ， 
包含 了 一 个 隐藏 的 表单 元 素 "next' ， 其 中 的 实 参 
value 告诉 Django 在 用 户 成 功 登录 后 将 其 重 定 同 到 什 
么 地 方 。 在 本 例 中 ， 用 户 将 返回 主页 。 


. 链接 到 登录 页 面 


下 面 在 base.html 中 添加 到 登录 页 面 的 链接 ， 让 所 有 页 
面 都 包含 它 。 用 户 已 登录 时 ， 我 们 不 想 显 示 这 个 链 
接 ， 因 此 将 它 租 套 在 一 个 {% if %} 标签 中 : 


base.html 


<p> 
<a href="{% url 'learning logs:index' %}">Learning 
<a href="{% url ‘learning logs:topics' %}">Topicsx</t 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
{% else %} 


<a href="{% Url ‘users:login' %}">Log in</ay> 
{% endif %} 
</p> 


{% block content %}{% endblock content %} 


在 Django 身 份 验证 系统 中 ， 每 个 模板 都 可 使 用 变量 
user 。 这 个 变量 有 一 个 is_authenticated 属性 : 
如 果 用 户 已 登录 ， 该 属性 将 为 True ， 人 否则 为 False 
。 这 让 你 能 够 癌 已 通过 身份 验证 的 用 户 显 示 一 条 消 
息 ， 而 向 未 通过 身份 验证 的 用 户 显 示 另 一 条 消息 。 


这 里 向 已 登录 的 用 户 显 示 问 候 语 ( 见 @) 。 对 于 已 通 
过 身份 验证 的 用 户 ， 还 设置 了 属性 username 。 这 里 
使 用 该 属性 来 个 性 化 问候 语 ， 让 用 户 知道 自己 已 登录 
( 见 @@) 。 在 全 处 ， 对 于 尚未 通过 身份 验证 的 用 户 ， 
显示 到 登录 页 面 的 链接 。 


. 使 用 登录 页 面 


前 面 建 江 了 一 个 用 户 账户 ， 下 面 来 登录 一 下 ， 看 看 登 
录 页 面 是 售 管 用 。 请 访问 
http://localhost:8000/admin/， 如 果 你 依然 是 以 管理 员 
身份 登录 的 ， 请 在 页 眉 上 找到 注销 链接 并 单 击 它 。 


注销 后 ， 访 问 http://localhost:8000/users/login/ 将 看 到 
类 似 于 图 19-4 所 示 的 登录 页 面 。 输 入 你 在 前 面 设置 的 
用 户 名 和 密码 ， 将 进入 索引 页 面 。 在 这 个 主页 的 页 丑 
中 ， 显 示 了 一 条 个 性 化 问候 语 ， 其 中 包含 你 的 用 户 


名 。 


OO@@e@ x 仿 localhost:8000/users/login/ (9 © 由 


Learning Log - Topics - Log in 


Username: 
Password: 


Log in 


图 19-4 登录 页 面 

19.2.5 ”注销 

现在 需要 提供 一 个 让 用 户 注销 的 途径 。 为 此 ， 我 们 将 在 

base.html 中 添加 一 个 注销 链接 。 用 户 单 击 这 个 链接 时 ， 将 

进入 一 个 确认 其 已 注销 的 页 面 。 

Qa.， 在 base.html 中 添加 注销 链接 

下 面 在 base.html 中 添加 注销 链接 ， 让 每 个 页 面 都 包含 
它 。 将 注销 链接 放 在 {% if 
user.is_authenticated %} 部 分 中 ， 这 样 人 只 有 已 
登录 的 用 户 才 能 看 到 它 : 


base.html 


--Snip-- 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
<a href="{% url ‘users:logout' %}">Log out</a> 


{% else %} 
--Snip-- 


默认 的 具名 注销 URL 模 式 为 'logout ' 。 


B. 注销 确认 页 面 
成 功 注 销 后 ， 用 户 和 希望 获悉 这 一 点 。 因 此 默认 的 注销 
视图 使 用 模板 logged_out.html 泻 染 注销 确认 页 面 ， 我 
们 现在 束 来 创建 该 模板 。 下 面 这 个 简单 的 页 面 确认 用 
户 已 注销 ， 请 将 其 存储 到 目录 
templates/registration (login.html 所 在 的 目录 ) 中 : 


logged_out.html 


{% extends "learning logs/base.html" %} 


{% block content %} 


<p>You have been logged out. Thank you for visiting!< 
{% endblock content %} 


在 这 个 页 面 中 ， 不 需要 提供 其 他 内 容 ， 因 为 base.html 
提供 了 到 主页 和 登录 页 面 的 链接 。 


图 19-5 显 示 了 用 户 单 击 Log out 链 接 后 出 现 的 注销 确认 
页 面 。 这 里 的 重点 是 创建 能 够 正确 工作 的 网 站 ， 因 此 
几乎 没有 设置 样式 。 确 定 所 需 的 功能 都 能 正确 运行 
人 我 们 将 设置 这 个 网 站 的 样式 ， 使 其 看 起 来 更 专 
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You have been logged out. Thank you for visiting! 


图 19-5 ”注销 确认 页 面 指出 用 户 已 成 功 注销 
19.2.6 ”注册 页 面 
下 面 来 创建 一 个 页 面 供 新 用 户 注册 。 我 们 将 使 用 Django 提 
供 的 表单 UserCreationForm ， 但 编写 目 己 的 视图 函数 和 
模板 。 
a. 注册 页 面 的 URE 模式 


下 面 的 代码 定义 了 注册 页 面 的 URL 模 式 ， 它 也 包含 在 
users/urls.py 中 : 


urls.py 


"" 为 应 用 程序 users 定 义 URL 模 式 。""" 


from django.urls import path, include 


from . import views 


app_name = 'Users' 
urlpatterns = [ 
# 包含 默认 的 里 份 验证 URL。 
path('', include('django.contrib.auth.urls')), 
# 注册 页 面 
path('register/', views.register, name='register'), 


我 们 从 users 中 导入 模块 views 。 为 何 需要 这 样 做 
呢 ? 因 为 我 们 将 为 注册 页 面 编写 视 图 函数 。 注 册页 面 
的 URL 模 式 与 URL http://localhost:8000/users/register/ 
匹配 ， 并 将 请 求 有 送 给 即将 编写 的 函数 register() 


B. 视图 函数 register() 


在 注册 页 面 首次 被 请 求 时 ， 视 图 函数 register() 需 


要 显示 一 个 空 的 注册 表单 ， 并 在 用 户 提 交 填 写 好 的 注 
册 表 单 时 对 其 进行 处 理 。 如 果 注 册 成 功 ， 这 个 函数 还 
需 让 用 户 自动 登录 。 请 在 users/views.py 中 添加 如 下 代 
码 : 


views.py 


from django.shortcuts import render, redirect 
from django.contrib.auth import login 
from django.contrib.auth.forms import UserCreationFor 


def register(request): 
"" "注册 新 用 户 。""" 
if request.method != 'POST': 
# 显示 空 的 注册 表单 。 
form = UserCreationForm() 
else: 
# 处 理 填 写 好 的 表单 。 


form = UserCreationForm(data=request.POST) 


if form.is valid(): 

new_user = form.save() 

# 证 用 户 自 动 登录 ， 再 重 定向 到 主页 。 
login(request, new user) 
return redirect('learning logs:index') 


# 显示 空 表 单 或 指出 表单 无 效 。 
context = {'form': form} 
return render(request, 'registration/register.htm 


首先 导入 函数 render() 和 redirect() ， 然 后 导入 
函数 login() ， 以 便 在 用 户 正 确 填写 了 注册 信息 时 让 
其 自动 登录 。 我 们 还 导入 了 默认 表 

单 UserCreationForm 。 在 函数 register() 中 ， 检 
查 要 响应 的 是 否 是 POST 请 求 。 如 果 不 是 ， 就 创建 一 
个 UserCreationForm 实例 ， 且 不 给 它 提 供 任 何 初始 
数据 ( 见 @) . 


如 果 啊 应 的 是 POST 请 求 ， 束 根据 提 区 的 数据 创建 一 
个 UserCreationForm 实例 〈 见 贸 ) ， 并 检查 这 些 数 


据 是 否 有 效 ( 见 @) 。 就 本 例 而 言 ， 有 效 是 指 用 户 名 
未 包含 非法 字符 ， 输 入 的 两 个 密码 相同 ， 以 及 用 户 没 
有 试图 做 恶意 的 事情 。 


如 果 提 交 的 数据 有 效 ， 就 调用 表单 的 方法 save() ， 
将 用 户 名 和 密码 的 散 列 值 保存 到 数据 库 中 ( 见 @) 。 
方法 save() 返回 新 创建 的 用 户 对 象 ， 我 们 将 它 赋 给 
了 new_user 。 保 存 用 户 的 信息 后 ， 调 用 函 

数 login() 并 传 入 对 象 request 和 new_user ， 为 用 
户 创建 有 效 的 会 话 ， 从 而 让 其 自动 登录 ( 见 @) 。 最 
后 ， 将 用 户 重 定向 到 主页 〈 见 @@) ， 而 主页 的 页 眉 中 
0 问候 语 ， 让 用 户 知道 注册 成 功 


在 这 个 函数 的 末尾 ， 我 们 泻 染 了 注册 页 面 : 它 要 么 显 
示 一 个 空 表单 ， 要 么 显示 提交 的 无 效 表 单 。 


. 注册 模板 
下 面 来 创建 注册 页 面 的 模板 ， 它 与 登录 页 面 的 模板 类 
似 。 请 务必 将 其 保存 到 login.html 所 在 的 目录 中 : 


register.html 


{% extends "learning logs/base.html" %} 
{% block content %} 


<form method="post" action="{% url 'users:register' % 
{% csrf token %} 
{{ form.as_p }} 


<button name="submit">Register</button> 
<input type="hidden" name="next" value="{? 
</form> 


{% endblock content %} 


这 里 也 使 用 了 方法 as _p ， 让 Django 在 表单 中 正确 地 


显示 所 有 的 字段 ， 包 括 错误 消息 一 一 如 果 用 户 没 有 正 
确 地 填写 表单 。 
. 链接 到 注册 页 面 


下 面 来 添加 一 些 代 码 ， 在 用 户 没有 登录 时 显示 到 注册 
页 面 的 链接 : 


base.html 


--Snip-- 
{% if user.is authenticated %} 
Hello, {{ user.username }}. 
<a href="{% url ‘users:logout' %}">Log out</a> 
{% else %} 
<a href="{% url ‘users:register' %}">Register</a> - 


<a href="{% url 'users:login' %}">Log in</ay> 
{% endif %} 
--Snip-- 


现在 ， 已 登录 的 用 户 看 到 的 是 个 性 化 的 问候 语 和 注销 
链接 ， 而 未 登录 的 用 户 看 到 的 是 注册 链接 和 登录 链 
户 账户 。 


下 一 节 会 将 一 些 页 面 限制 为 仅 让 已 登录 的 用 户 访问 ， 
还 将 确保 每 个 主题 部 归属 于 特定 用 户 。 


注意 ”这 里 的 注册 系统 允许 用 户 创建 任意 数量 
的 账户 。 有 些 系统 要 求 用 户 确认 其 身份 : 及 送 一 
封 确认 邮件 ， 用 户 回复 后 账户 才 生 效 。 通 过 这 样 
做 ， 这 些 系统 会 比 本 例 的 简单 系统 生成 更 少 的 二 
圾 账户 。 然 而 ， 学 习 创 建 应 用 程序 时 ， 完 全 可 以 
像 这 里 所 做 的 那样 ， 使 用 简单 的 用 尸 注册 系 统 。 


动手 试 一 斌 


练习 19-2: 博客 账户 ”在 为 完成 练习 19-1 而 开发 的 项 
目 Blog 中 ， 添 加 用 户 身份 验证 和 注册 系统 。 向 已 登录 
的 用 户 显 示 其 用 户 名 ， 回 未 注册 的 用 户 显示 到 注册 页 
面 的 链接 。 


19.3 ”让 用 户 拥 有 自己 的 数据 


用 户 应 该 能 够 输入 其 专 有 的 数据 ， 因 此 我 们 将 创建 一 个 系 
统 ， 确 定 各 项 数据 所 属 的 用 户 ， 再 限制 对 页 面 的 访问 ， 让 
用 户 只 能 使 用 上 自己 的 数据 。 


本 市 将 修改 模型 Topic ， 让 每 个 主题 都 归属 于 特定 用 户 。 
这 也 将 影响 条 目 ， 因 为 每 个 条 目 都 属于 特定 的 主题 。 我 们 
先 来 限制 对 一 些 页 面 的 访问 。 


19.3.1 使 用 @login_required 限制 访问 


Django 提 供 了 装饰 器 @login_required ， 让 你 能 够 轻松 
地 只 人 允许 已 登录 用 户 访问 某 些 页 面 。 装 饰 嚣 (decorator) 
是 放 在 函数 定义 前 面 的 指令 ，Python 在 函数 运行 前 根据 它 
来 修改 函数 代码 的 行为 。 下 面 来 看 一 个 示例 。 


a. 限制 访问 显示 所 有 主题 的 页 面 
每 个 主题 都 归 特 定 用 户 所 有 ， 因 此 应 只 允许 已 登录 的 


用 户 请 求 显示 所 有 主题 的 页 面 。 为 此 ， 在 
learning_logs/views.py 中 添加 如 下 代码 : 


views.py 


from django.shortcuts import render, redirect 
from django.contrib.auth.decorators import login requirg 


from .models import Topic, Entry 
--Snip-- 


@login required 

def topics(request): 
""" 显 示 所 有 的 主题 。""" 
--Snip-- 


首先 导入 函数 login_required() 。 

将 login_required() 作为 装饰 右 应 用 于 视图 函 

数 topics() 一 一 在 它 前 面 加 上 符号 Q 和 
login_required ， 让 Python 在 运行 topics() 的 代 
码 之 前 运行 1ogin_required() 的 代码 。 


login_required() 的 代码 检查 用 户 是 否 已 登录 ， 仅 
当 用 户 已 登录 时 ，Django 才 运行 topics() 的 代码 。 
如 有 果 用 户 未 登录 ， 就 重 定 同 到 登录 页 面 。 


为 实现 这 种 重 定向 ， 需 要 修改 settings.py， 让 Django 
知道 到 哪里 去 查找 登录 页 面 。 请 在 settings.py 末 尾 添 
加 如 下 代码 : 


settings.py 


--Snip-- 


# 我 的 设置 


LOGIN URL = 'users:1login' 


现在 ， 如 果 未 登录 的 用 户 请 求 装饰 
器 0login_required 你 护 的 页 面 ，Django 将 重 定 问 
到 settings.py 中 的 LOGIN_URL 指定 的 URL。 


要 测试 这 个 设置 ， 可 注销 并 进入 主页 ， 再 单 击 链 接 
Topics， 这 将 重 定向 到 登录 页 面 。 然 后 ， 使 用 你 的 账 
户 登录 ， 并 再 次 单 击 主 页 中 的 Topics 链 接 ， 你 将 看 到 
显示 所 有 主题 的 页 面 。 


. 全 面 限制 对 项 目 “ 学 习 笔记 ”的 访问 


Django 让 你 能 够 轻松 地 限制 对 页 面 的 访问 ， 但 你 必须 
确定 要 保护 哪些 页 面 。 最 好 先 确 定 项 目的 哪些 页 面 不 
需要 保护 ， 再 限制 对 其 他 所 有 页 面 的 访问 。 你 可 轻松 
地 修改 过 于 严格 的 访问 限制 。 比 起 不 限制 对 敏感 页 面 


的 访问 ， 这 样 做 的 风险 更 低 。 


在 项 目 “ 学 习 笔 记 ? 中 ， 将 不 限制 对 主页 和 注册 页 面 的 
访问 ， 并 限制 对 其 他 所 有 页 面 的 访问 。 


在 下 面 的 learning_logs/views.py 中 ， 对 除 index() 外 
的 每 个 视图 都 应 用 了 装饰 器 @login_required : 


Views.py 


--Snip-- 

@login required 

def topics(request): 
--Snip-- 


@login required 
def topic(request, topic id): 
--Snip-- 


@login required 
def new topic(request): 
--Snip-- 


@login required 
def new entry(request, topic id): 
--Snip-- 


@login required 
def edit entry(request, entry id): 
--Snip-- 


如 有 果 你 在 未 登录 的 情况 下 尝试 访问 这 些 页 面 ， 将 被 重 
定向 到 登录 页 面 。 另 外 ， 你 还 不 能 单 击 到 new_topic 
等 页 面 的 链接 。 如 果 你 输入 URL 
http://localhost:8000/new_topic/， 将 被 重 定 癌 到 登录 页 
面 。 对 于 所 有 与 私有 用 户 数 据 相 关 的 URL， 都 应 限制 
访问 。 


19.3.2 ”将 数据 关联 到 用 户 


现在 ， 需 要 将 数据 关联 到 提交 它们 的 用 户 。 只 需 将 最 高 层 
的 数据 关联 到 用 户 ， 更 低层 的 数据 就 会 自动 天 联 到 用 户 。 
例如 ， 在 项 目 “ 学 习 笔记 ”中 ， 应 用 程序 的 最 高 层 数 据 是 主 
题 ， 而 所 有 条 目 都 与 特定 主题 相关 联 。 只 要 每 个 主题 都 归 
属于 特定 用 户 ， 惑 能 确定 数据 库 中 每 个 条 目的 所 有 者 。 

下 面 来 修改 模型 Topic ， 在 其 中 添加 一 个 关联 到 用 户 的 外 
键 。 这 样 做 之 后 ， 必 须 对 数据 库 进 行 迁移 。 最 后 ， 必 须 修 
Te 使 其 只 显示 与 当前 登录 的 用 户 相 关联 的 数 

量 。 

Q. 修改 模型 Topic 


对 models.py 的 修改 只 涉及 两 行 代码 : 


models.py 


from django.db import models 
from django.contrib.auth.models import User 


class Topic(models.Model) : 
“"" 用 户 学 习 的 主题 。""" 
text = models.CharField(max_length=280) 
date added = models.DateTimeField(auto now add=True 
owner = models.ForeignKey(User, on delete=models.CA9 


def _str (self): 
"" "返回 模型 的 字符 串 表示 。""" 
return self.text 


class Entry(models.Model) : 
--Snip-- 


首先 导入 django.contrib.auth 中 的 模型 User ， 然 
后 在 Topic 中 添加 字段 owner ， 它 建立 到 模型 User 
的 外 键 关系 。 用 户 被 删除 时 ， 所 有 与 之 相关 联 的 主题 
也 会 被 删除 。 


B. 确定 当前 有 哪些 用 户 


迁移 数据 库 时 ，Django 将 对 数据 库 进 行 修改 ， 使 其 能 
够 存储 主题 和 用 户 之 间 的 关联 。 为 执行 迁移 ，Django 
需要 知道 该 将 各 个 既 有 主题 关联 到 哪个 用 户 。 最 简单 
的 办 法 是 ， 将 既 有 主题 都 关联 到 同一 个 用 户 ， 如 超级 
用 户 。 为 此 ， 需 要 知道 该 用 户 的 ID。 


下 面 来 得 看 忆 创 建 的 所 有 用 记 的 了 p。 为 此 ， 启 动 一 个 
Django shell 会 话 ， 并 执行 如 下 命令 : 


(11_env)learning log$ python manage.py shell 
@ >>> from django.contrib.auth.models import User 
@ >>> User.objects.all() 
<Queryset [<User: 11 admin>, <User: eric>, <User: wil 
日 >>> for user in User.objects.all(): 
print(user.username, user.id) 


11 admin 1 
eric 2 
willie 3 
>>> 


在 @ 处 ， 在 shell 会 话 中 导入 模型 User 。 然 后 ， 查 看 
到 目前 为 止 都 创建 了 哪些 用 户 〈 见 四 ) 。 输 出 中 列 出 
了 三 个 用 户 : 1admin、eric 和 willie。 


在 全 处 ， 遍 历 用 户 列 表 并 打印 每 位 用 户 的 用 户 名 和 
ID。Django 询 问 要 将 既 有 主题 关联 到 哪个 用 户 时 ， 我 
们 将 指定 其 中 一 个 ID 值 。 


Y 迁移 数据 库 


知道 用 户 ID 后 ， 就 可 迁移 数据 库 了 。 这 样 做 时 ， 
Python 将 询问 你 是 要 暂时 将 模型 Topic 关联 到 特定 用 


户 ， 还 是 在 文件 models.py 中 指定 默认 用 户 。 请 选择 第 
一 个 选项 。 


(11_env)learning log$ python manage.py makemigrations 
You are trying to add a non-nullable field 'owner' to 
we can't do that (the database needs something to pop 
Please select a fix: 

1) Provide a one-off default now (will be set on al 

null value for this column) 

2) Quit, and let me add a default in models.py 
Select an option: 1 
Please enter the default value now, as valid Python 
The datetime and django.utils.timezone modules are avd 
e.g. timezone.now 
Type "exit ”to exit this prompt 
>>> 1 
Migrations for 'learning logs': 

learning logs/migrations/6663 topic owner.py 
- Add field owner to topic 
(11_env)learning log$ 


首先 执行 命令 makemigrations ( 见 @) 。 在 全 处 的 
输出 中 ，Django 指 出 你 试图 给 既 有 模型 Topic 添加 一 
个 必 不 可 少 《〈 不 可 为 空 ) 的 字段 ， 而 该 字段 没有 默认 
值 。 在 全 处 ，Django 提 供 了 两 种 选择 要 么 现在 提供 
默认 值 ， 要 么 退出 并 在 models.py 中 添加 默认 值 。 在 人 @ 
处 ， 我 们 选择 了 第 一 个 选项 ， 因 此 Django 让 我 们 输入 
默认 值 ( 见 @) 。 


为 将 所 有 既 有 主题 都 关联 到 管理 用 户 1_admin， 我 们 
输入 用 户 ID 值 1 〈 见 @) 。 可 以 使 用 已 创建 的 任何 用 
户 的 ID， 而 非 必 须 是 超级 用 户 。 接 下 来 ，Django 使 用 
这 个 值 来 迁移 数据 库 ， 并 生成 了 迁移 文件 
0003_topic_owner.py， 它 在 模型 Topic 中 添加 字 鼎 
owner 。 


现在 可 以 执行 迁移 了 。 为 此 ， 在 活动 状态 的 虚拟 环境 
中 执行 如 下 命令 : 


(11_env)learning log$ python manage.py migrate 
Operations to perform : 

Apply all migrations: admin, auth, contenttypes, le 
Running migrations : 


@ Applying learning_logs.6663 topic owner... OK 
(11_env)learning log$ 


Django 应 用 新 的 迁移 ， 结 果 一 切 顺 利 ( 见 @) 。 
为 验证 迁移 符合 预期 ， 可 在 shell 会 话 中 像 下 面 这 样 
做 : 


@ >>> from learning logs.models import Topic 
@ >>> for topic in Topic.objects.all(): 
print(topic, topic.owner) 


Chess 11 admin 
Rock Climbing 11 admin 
>>> 


我 们 从 learning_ logs.models 中 导入 Topic ( 见 

@) ， 再 遍历 所 有 的 既 有 主题 ， 并 打印 每 个 主题 及 其 
所 属 的 用 户 ( 见 @) 。 如 你 所 见 ， 现 在 每 个 主题 都 属 
于 用 户 1_admin。 如 果 你 在 运行 这 些 代码 时 出 错 ， 请 
尝试 退出 并 重启 shell。 


注意 ”你 可 以 重 置 数 据 库 而 不 是 迁移 它 ， 但 如 
果 这 样 做 ， 既 有 的 数据 都 将 丢失 。 一 种 不 错 的 做 
法 是 ， 学 习 如 何在 迁移 数据 库 的 同时 确保 用 户 数 
据 的 完整 性 。 如 果 你 确实 想 要 一 个 全 新 的 数据 
库 ， 可 执行 命令 python manage.py flush ， 
这 将 重建 数据 库 的 结构 。 如 果 这 样 做 ， 就 必须 重 
新 创建 超级 用 户 ， 且 原来 的 所 有 数据 都 将 丢失 。 


19.3.3 ”只 人 允许 用 户 访 问 上 自己 的 主题 


当前 ， 不 管 以 哪个 用 户 的 身份 登录 ， 都 能 够 看 到 所 有 的 主 
题 。 下 面 改变 这 一 把， 只 问 用 户 显 示 属 于 其 自己 的 主题 。 


在 views.py 中 ， 对 函数 topics() 做 如 下 修改 : 


views.py 


--Snip-- 
@login required 
def topics(request): 
""" 显 示 所 有 的 主题 。""" 
topics = Topic.objects.filter(owner=request.user).order | 


context = {'topics': topics} 
return render(request, 'learning logs/topics.html', cont 
--Snip-- 


用 户 登 录 后 ，request 对 象 将 有 一 个 user 属 性 ， 其 中 存储 
了 有 关 该 用 户 的 信息 。 但 询 
Topic.objects.filter(owner=request.user) 让 
Django 只 从 数据 库 中 获取 owner 属性 为 当前 用 户 的 Topic 
对 象 。 由 于 没有 修改 主题 的 显示 方式 ， 无 须 对 显示 所 有 主 
题 的 页 面 的 模板 做 任何 修改 。 


要 但 看 结果 ， 以 所 有 既 有 主题 关联 到 的 用 户 的 身份 登录 ， 
并 访问 显示 所 有 主题 的 页 面 ， 你 将 看 到 所 有 的 主题 。 然 

a 注销 并 以 妨 一 个 用 户 的 映 份 登录 ， 该 页 面 将 不 列 出 任 
可 主题 。 


19.3.4 ”保护 用 户 的 主题 


我 们 还 没有 限制 对 显示 单个 主题 的 页 面 的 访问 ， 因 此 任何 
己 登 录 的 用 户 都 可 输入 类 似 于 http://ocalhost:8000/topics/1/ 
的 URL， 来 访问 显示 相应 主题 的 页 面 。 


你 上 自己 试 一 试 就 明白 了 。 以 拥有 所 有 主题 的 用 户 的 喘 份 登 
录 ， 访 问 特定 的 主题 ， 并 复制 该 页 面 的 URL 或 将 其 中 的 ID 
记录 下 来 。 然 后 ， 注 销 并 以 兄 一 个 用 户 的 身份 登录 ， 再 输 
入 显示 前 述 主题 的 页 面 的 URL。 虽 然 你 是 作为 另 一 个 用 户 
登录 的 ， 但 依然 能 够 得 看 该 主题 中 的 条 目 。 


为 修复 这 种 问题 ， 我 们 在 视图 函数 topic() 获取 请 求 的 条 
目前 执行 检查 : 


views.py 


from django.shortcuts import render, redirect 
from django.contrib.auth.decorators import login required 
from django.http import Http464 


--Snip-- 
@login required 
def We topic id) : 
"显示 单个 主题 及 其 所 有 的 条 目 。 
topic = > objects. i topic id) 
# 确认 请 求 的 主题 属于 当前 用 户 。 
if topic.owner != request.user: 
raise Http464 


entries = topic.entry_ set.order by('-date added') 

context = {'topic': topic, "entries': entries} 

return render(request, 'learning logs/topic.html', con 
--Snip-- 


服务 器 上 没有 请 求 的 资源 时 ， 标 准 的 做 法 是 返回 404 响 
应 。 这 里 导入 了 异常 Http464 ( 见 @) ， 并 在 用 户 请 求 其 
不 应 查看 的 主题 时 引发 这 个 异常 。 收 到 主题 请 求 后 ， 在 泻 
染 页 面前 检查 该 主题 是 否 属 于 当前 登 录 的 用 户 。 如 果 请 求 
的 主题 不 归 当 前 用 户 所 有 ， 就 引发 Http464 异常 〈 见 
全 ) ， 让 Django 返 回 一 个 404 错 误 页 面 。 


现在 ， 如 果 你 试图 查看 其 他 用 户 的 主题 条 目 ， 将 看 到 
Django 发 送 的 消息 Page Not Found。 第 20 章 将 对 这 个 项 目 
进行 配置 ， 让 用 户 看 到 更 合适 的 错误 页 面 。 


19.3.5 ”保护 页 面 edit_entry 


页 面 edit_entry 的 URL 形 式 

为 http://localhost:86066/edit entry/entry id / 
， 其 中 ey 是 一 个 数 。 下 面 来 保护 这 种 页 面 ， 禁 
Eos 通过 输入 类 似 于 前 面 的 URL 来 访问 其 他 用 户 的 条 


views.py 


--Snip-- 

@login required 

def edit entry(request, entry id): 
"" "编辑 既 有 条 目 。""" 
entry = Entry.objects.get(id=entry_id) 
topic = entry.topic 


if topic.owner != request.user: 
raise Http464 


if request.method != "POST ': 
--Snip-- 


我 们 首先 获取 指定 的 条 目 以 及 与 之 相关 联 的 主题 ， 再 检查 
主题 的 所 有 者 是 否 是 当前 登录 的 用 户 。 如 果 不 是 ， 就 引发 
Http464 异常 。 


19.3.6 ”将 新 主题 关联 到 当前 用 户 


当前 ， 用 于 添加 新 主题 的 页 面 存在 问题 一 一 没有 将 新 主题 
关联 到 特定 用 户 。 如 果 你 尝试 添加 新 主题 ， 将 看 到 错误 消 
晨 IntegrityError ， 指 出 

learning logs_topic.user_id 不 能 为 NULL (NOT 
NULL Constraint failed : 

learning_ logs_topic.owner_ id ) 。Django 的 意思 是 


说 ， 创 建新 主题 时 ， 必 须 给 owner 字段 指定 值 。 


我 们 可 通过 request 对 象 获悉 当前 用 户 ， 因 此 有 一 个 修复 
该 问题 的 简单 方案 。 请 添加 下 面 的 代码 ， 将 新 主题 关联 到 
当前 用 户 : 


views.py 


--Snip-- 
@login required 
def new_ topic(request): 
"" "添加 新 主题 。""" 
if request .method != "POST ': 


# 没有 提交 的 数据 : 创建 一 个 空 表单 。 
form = TopicForm() 
else: 
# POST 提交 的 数据 : 对 数据 进行 处 理 。 
form = TopicForm(data=request.POST) 
if form.is valid(): 
new_ topic = form.save(commit=False) 
@ new topic.owner = request.user 
new _ topic.save() 
return redirect('learning logs:topics ') 


@ 


© 


# 显示 一 个 空 表 单 或 指出 表单 无 效 。 

context = { form': form} 

return render(request, 'learning logs/new topic.html', 
--Snip-- 


首先 调用 form.save() 并 传递 实 参 commit=False ( 见 

@) ， 因 为 要 先 修改 新 主题 ， 再 将 其 保存 到 数据 库 。 接 下 
来 ， 将 新 主题 的 owner 属性 设置 为 当前 用 户 ( 见 @) 。 最 
后 ， 对 刚 定 义 的 主题 实例 调用 save() 〈 见 人 @) 。 现 在 ， 

主题 包含 所 有 必 不 可 少 的 数据 ， 将 被 成 功 保存 。 


这 个 项 目 现在 允许 任何 用 户 注册 ， 而 每 个 用 户 想 添加 多 少 
新 主题 都 可 以 。 每 个 用 户 都 只 能 访问 目 己 的 数据 ， 无 论 是 
查看 数据 、 输 入 新 数据 还 是 修改 旧 数 据 时 都 如 此 。 


动手 试 一 斌 


练习 19-3: 重 构 ”在 views.py 中 ， 我 们 在 两 个 地 方 核 
实 了 主题 关联 到 的 用 户 为 当前 登录 的 用 户 。 请 将 执行 
这 种 检查 的 代码 放 在 函数 check_topic_owner() 
中 ， 并 在 这 两 个 地 方 调用 该 函数 。 


练习 19-4: 保护 页 面 new_entry 一 个 用 户 可 在 另 一 
个 用 户 的 学 习 笔记 中 添加 条 目 ， 方 法 是 在 URL 中 指定 
属于 另 一 个 用 户 的 主题 的 ID 。 为 防范 这 种 攻击 ， 请 在 
保存 新 条 目 之 前 ， 核 实 它 所 属 的 主题 归属 于 当前 用 


SS 


万 


练习 19-5: 受 保护 的 博客 ”在 你 创建 的 项 目 Blog 

中 ， 确 保 每 篇 博文 都 与 特定 用 户 相 关联 。 确 保 任 何 用 
户 都 可 访问 所 有 的 博文 ， 但 只 有 已 登录 的 用 户 能 够 发 
表 博 文 和 编辑 既 有 博文 。 在 让 用 户 编辑 博文 的 视图 
中 ， 在 处 理 表单 前 确认 用 户 编辑 的 是 其 目 己 发 表 的 博 
文 。 


19.4 ”小结 


在 本 章 中 ， 你 学 习 了 : 如 何 使 用 表单 来 让 用 户 添 加 新 主 
题 、 添 加 新 条 目 以 及 编辑 既 有 和 条目， 如 何 实现 用 户 账 户 ， 
让 老 用 户 能 够 登录 和 注销 ， 并 且 使 用 Django 提 供 的 表 
单 UserCreationForm 让 用 户 创 建新 账户 。 


建立 简单 的 用 户 身份 验证 和 注册 系统 后 ， 你 使 用 装饰 
器 @login_required 禁止 未 登录 的 用 户 访问 特定 页 面 。 
然后 ， 你 通过 使 用 外 键 将 数据 关联 到 特定 用 户 ， 还 迁移 了 
要 求 指定 默认 数据 的 数据 库 。 


最 后 ， 你 学 习 了 如 何 修 改 视图 函数 ， 让 用 户 只 能 看 到 属于 
自己 的 数据 。 你 使 用 方法 filter() 来 获取 合适 的 数据 ， 
0 SE 
行 比 较 。 


该 让 哪些 数据 可 随便 访问 ， 又 该 对 哪些 数据 进行 保护 呢 ? 
这 可 能 并 非 总 是 那么 显而易见 ， 但 通过 不 断 地 练习 就 能 掌 
握 这 种 技能 。 我 们 在 本 章 中 区 该 如 何 保护 用 户 数据 所 做 的 
决策 表明 ， 与 人 合作 开发 项 目 是 个 不 错 的 主意 : 在 有 人 对 
项 目 进 行 检查 的 情况 下 ， 更 容易 及 现 其 薄弱 环节 。 


至 此 ， 我 们 创建 了 一 个 功能 齐备 的 项 目 ， 它 运行 在 本 地 计 
算 机 上 。 在 本 书 的 最 后 一 章 ， 我 们 将 设置 这 个 项 目的 样 
式 ， 使 其 更 漂 宫 ， 还 将 把 它 部 著 到 一 台 服 务 器 上 ， 让 任何 
人 部 可 通过 互联 网 注册 并 创建 账户 。 


第 20 章 ”设置 应 用 程序 的 
样式 并 部 理 


NG 当前 ， 项 目 “ 学 习 笔记 ”虽然 功能 齐备 ， 但 
未 设置 样式 ， 也 只 能 在 本 地 计算 机 上 运行 。 在 本 章 
中 ， 我 们 将 以 简单 而 专业 的 方式 设置 这 个 项 目的 样 
式 ， 再 将 其 部 署 到 一 台 服 务 嚣 上， 让 世界 上 的 任何 人 
都 能 够 建立 账户 。 


为 设置 样式 ， 我 们 将 使 用 Bootstrap 库 ， 这 是 一 组 工具 ， 用 
于 为 Web 应 用 程序 设置 样式 ， 使 其 在 任何 现代 设备 上 都 看 
起 来 很 专业 ， 无 论 是 大 型 的 平板 显示 器 还 是 智能 手机 。 为 
此 ， 我 们 将 使 用 应 用 程序 django-bootstrap4， 这 也 让 你 能 

够 练习 使 用 其 他 Django 开 发 人 员 开 发 的 应 用 程序 。 


我 们 将 把 项 目 “ 学 习 笔记 ?部署 到 Heroku， 这 个 网 站 让 你 能 
够 将 项 目 推送 到 其 服务 器 ， 让 任何 有 互联 网 连接 的 人 都 可 
以 使 用 它 。 我 们 还 将 使 用 版 本 控制 系统 Git 来 跟 中 对 这 个 
项 目 所 做 的 修改 。 


完成 项 目 “ 学 习 笔记 ”后 ， 你 将 能 够 开发 简单 的 Web 应 用 程 
序 ， 让 它们 看 起 来 很 深 腕 ， 再 将 其 部 普 到 服务 器。 你 还 能 
够 利用 更 扁 级 的 学 习 资源 来 提高 技能 。 


20.1 设置 项 目 “ 学 习 笔记 ?的 样式 


之 前 ， 我 们 特意 一 直 专注 于 项 目 < 学 习 笔记 ”的 功能 ， 没 有 
考虑 样式 设置 问题 。 这 是 一 种 不 错 的 开发 方法 ， 因 为 能 

确 运行 的 应 用 程序 才 是 有 用 的 。 当 然 ， 应 用 程序 能 够 正确 
运行 后 ， 外 观 就 显得 很 重要 了 ， 因 为 漂亮 的 应 用 程序 才能 
吸引 用 户 。 


本 节 简 要 介绍 应 用 程序 django-bootstrap4， 并 演示 如 何 将 
其 集成 到 项 目 中 ， 为 部 署 做 好 准备 。 


20.1.1 ”应 用 程序 django-bootstrap4 


我 们 将 使 用 django-bootstrap4 将 Bootstrap 集 成 到 项 目 中 。 这 
个 应 用 程序 下 载 必要 的 Bootstrap 文 件 ， 将 其 放 到 项 目的 合 
适 位置 ， 让 你 能 够 在 项 目的 模板 中 使 用 样式 设置 指令 。 


为 安装 django-bootstrap4， 在 活动 状态 的 虚拟 环境 中 执行 


如 下 命令 : 


(11_env)learning log$ pip install django-bootstrap4 
--Snip-- 


Successfully installed django-bootstrap4-6.6.7 


接 下 来 ， 需 要 在 settings.py 的 INSTALLED_APPS 中 添加 如 
下 代码 ， 在 项 目 中 包含 应 用 程序 django- bootstrap4: 


settings.py 


--Snip-- 
INSTALLED_APPS = [ 
# 我 的 应 用 程序 


"learning_ logs', 


"Users ， 


# 第 三 方 应 用 程序 


"bootstrap4 ， 


# Django 默 认 添加 的 应 用 程序 
'django.contrib.admin', 
--Snip-- 


新 建 一 个 名 为 “第 三 方 应 用 程序 ”的 片段 ， 用 于 指定 其 他 开 
发 人 员 开 发 的 应 用 程序 ， 并 在 其 中 添加 'bootstrap4' 
务必 将 这 个 片段 放 在 “我 的 应 用 程序 ?和 “Django 默 认 添加 


的 应 用 程序 ”之 间 。 


20.1.2 ”使 用 Bootstrap 设 置 项 目 “ 学 习 笔记 ”的 样 
TC 


Bootstrap 是 一 个 大 型 样式 设置 工具 集 ， 还 提供 了 大 量 模 
板 ， 可 应 用 于 项 目 以 创建 独特 的 总 体 风格 。 对 Bootstrap 初 
学 者 来 说 ， 这 些 模 板 比 样式 设置 工具 用 起 来 容易 得 多 。 要 
查看 Bootstrap 提 供 的 模板 ， 可 访问 其 官方 网 站 ， 单 击 
Examples 并 找到 Navbars。 我 们 将 使 用 模板 Navbars static， 
它 提 供 了 简单 的 顶部 导航 栏 以 及 用 于 放置 页 面 内 容 的 容 
下 


图 20-1 显 示 了 对 base.html 应 用 这 个 Bootstrap 模 板 并 对 
index.html 做 细微 修改 后 的 主页 。 


Track your learning. 


Make your own a Log, and keep a list of the topics you're learning about. Whenever you learn 
something new about a topic, make an entry summarizing what you've learned 


图 20-1 项目“ 学 习 笔记 ”的 主页 一 ”使 用 Bootstrap 设 置 
样式 后 


20.1.3 ”修改 base.html 


我 们 需要 修改 模板 base.html， 以 使 用 前 述 Bootstrap 模 板 。 
下 面 分 几 部 分 介绍 新 的 base.html。 


QO. 


定义 HIML 头 部 

对 base.html 所 做 的 第 一 项 修改 是 ， 在 其 中 定义 HTML 
头 部 ， 使 得 显示 “学 习 笔 和 E 记 ”的 每 个 页 面 时 ， 浏览 器 标 
题 栏 都 显示 该 网 站 名 。 此 外 ， 还 要 添加 一 些 在 模板 中 
使 用 Bootstrap 所 需 的 信息 。 请 删除 base.html 的 全 部 代 
码 ， 并 输入 下 面 的 代码 : 

base.html 


@ {% load bootstrap4 %} 


@ <ldoctype html> 
日 <htm] lang="en"> 
@ <head> 
<meta charset="utf-8"> 
<meta name="viewport" content="width=device-width, 
shrink-to-fit=no"> 


<title>Learning Log</title> 


{% bootstrap_css %} 
{% bootstrap_ javascript jquery='full' %} 


@ </head> 


在 @@ 处 ， 加 载 django-bootstrap4 中 的 模板 标签 集 。 接 
下 来 ， 将 这 个 文件 声明 为 使 用 英语 ( 见 @) 编写 的 
HTML 文 档 ( 见 @@) 。HTML 文 件 分 为 两 个 主要 部 
分 : 头 部 〈head) 和 主体 〈body) 。 在 这 个 文件 
中 ， 关 亢 始 于 全 处 。 HTMEL 文 件 的 头 部 不 br 
容 ， 只 是 向 浏览 器 提供 正确 显示 页 面 所 需 的 信息 。@ 


处 包含 一 个 title 元 素 ， 在 浏览 器 中 打开 网 站 “学 习 
笔记 ”的 页 面 时， 浏览 器 的 标题 栏 将 显示 该 元 素 的 内 
谷 。 

在 @@ 处 ， 使 用 django-bootstrap4 的 一 个 自 定 义 模 板 标 
签 ， 让 Dijango 包 含 所 有 的 Bootstrap 样 式 文件 。 接 下 来 
的 标签 启用 你 可 能 在 页 面 中 使 用 的 所 有 交互 式 行为 ， 
如 可 折 且 的 导航 栏 。@ 处 为 结束 标签 </head> 。 


. 定义 导航 栏 

定义 页 面 项 部 导航 栏 的 代码 很 长 ， 因 为 需要 同时 支持 
较 军 的 手机 屏幕 和 较 宽 的 台式 计算 机 显示 器 。 我 们 将 
分 三 部 分 定义 导航 栏 。 

下 面 是 导航 栏 定义 代码 的 第 一 部 分 : 


base.html 


--Snip-- 
</head> 
@ <body> 


<nav class="navbar navbar-expand-md navbar-light bg 


<a class="navbar-brand" href="{% url 'learning lo# 


Learning Log</a> 


<button class="navbar-toggler" type="button" data 
data-target="#navbarCollapse" aria-controls=" 
aria-expanded="false" aria-label="Toggle navig 
<Span class="navbar-toggler-icon"></span></buttd 


第 一 个 元 素 为 起 始 标签 cbody> ( 见 @) 。HTML 文 
件 的 主体 包含 用 户 将 在 页 面 上 看 到 的 内 容 。 全 处 是 
一 个 <navy> 元 素 ， 表 示 页 面 的 导航 链接 部 分 。 对 于 这 
个 元 素 内 的 所 有 内 容 ， 都 将 根据 此 处 的 navbar 和 
navbar-expand-md 等 选择 器 定义 的 Bootstrap 样 式 规 


则 来 设置 样式 。 选 择 器 (selector) 决定 了 样式 规则 
将 应 用 于 页 面 上 的 哪些 元 素 。 选 择 器 navbar-1light 
和 bg-light 使 用 一 种 浅 色 主题 来 设置 导航 栏 的 颜 
色 。mb-4 中 的 mb 表示 下 边 距 (margin-bottom) ， 这 
个 选择 器 确保 导航 栏 和 页 面 其 他 部 分 之 间 有 一 些 空 白 
区 域 。 选 择 器 border 在 浅 色 背景 周围 添加 很 细 的 边 
框 ， 将 导航 栏 与 页 面 其 他 部 分 分 开 。 


在 全 处 ， 指 定 在 导航 栏 最 左 端 显示 项 目 名 ， 并 将 其 设 
置 为 到 主页 的 链接 ， 因 为 它 将 出 现在 这 个 项 目的 每 个 
页 面 中 。 选 择 器 navbar-brand 设置 这 个 链接 的 样 
使 其 比 其 他 链接 更 显眼 ， 这 是 一 种 网 站 推广 方 
了 


四 处 定义 了 一 个 按钮 ， 它 将 在 浏览 器 窗口 太 窗 、 无 法 
水 平 显示 整个 导航 栏 时 显示 出 来 。 如 果 用 户 单 击 这 个 
按钮 ， 将 出 现 一 个 下 拉 列 表 ， 其 中 包含 所 有 的 导航 元 
素 。 在 用 户 缩小 浏览 髓 窗口 或 在 屏幕 较 小 的 移动 设备 
上 显示 网 站 时 ，collapse 会 导致 导航 栏 折 县 起 来 。 


下 面 是 导航 栏 定义 代码 的 第 二 部 分 : 


base.html 


--Snip-- 
<Span class="navbar-toggler-icon"></span></buttd 
<div class="collapse navbar-collapse" id="navbarCd 
<ul class="navbar-nav mr-auto"> 
<li class="nav-item"> 


<a class="nav-link" href="{% url 'learning_ 
Topics</a></1i> 


</ul> 


@@ 处 开启 了 导航 栏 的 一 个 新 区 域 。div 是 division (分 
隔 ) 的 缩写 。 我 们 创建 页 面 时 ， 将 其 分 隔 成 多 个 区 
域 ， 并 指定 要 应 用 于 各 个 区 域 的 样式 和 行为 规则 。 
在 <div> 起 始 标 签 中 定义 的 样式 和 行为 规则 将 影响 下 
一 个 结束 标签 </div> 之 前 的 所 有 元 素 。 这 里 指定 了 


导 芝 或 窗口 太 定时 将 折 芝 起 来 的 导航 栏 部 分 的 起 始 位 


全 处 定义 了 一 组 链接 。Bootstrap 将 导航 元 素 定义 为 无 
序列 表 项 ， 但 使 用 的 样式 规则 让 它们 一 点 也 不 像 列 
表 。 导 航 栏 中 的 每 个 链接 或 元 素 都 能 以 列表 项 的 方式 
定义 。 这 里 只 有 一 个 列表 项 到 显示 所 有 主题 的 页 
面 的 链接 ( 见 @) 。 


下 面 是 导航 栏 定 义 代 码 的 最 后 一 部 分 


base.html 


--Snip-- 
</ul> 
<ul class="navbar-nav ml-auto"> 
{% if user.is authenticated %} 
<1i class="nav-item"> 
<Span class="navbar-text">Hello, 
</1i> 
<1i class="nav-item"> 
<a class="nav-link" href="{% url 
</1i> 
{% else %} 
<1i class="nav-item"> 
<a class="nav-link" href="{% url 
</1i> 
<1i class="nav-item"> 
<a class="nav-link" href="{% url 
{% endif %} 
</ul> 
@ </div> 


</nav> 


@@ 处 使 用 起 始 标签 cul> 定义 了 另 一 组 链接 (你 可 根 
据 需 要 在 页 面 中 包含 任意 数量 的 链接 编组 ) ， 这 组 链 
接 与 登录 和 注册 相关 ， 出 现在 导航 栏 最 右 端 。 选 择 
器 ml-auto 表示 目 动 左边 距 (margin- 和 
automatic) ， 它 根据 导航 栏 包 含 的 其 他 元 素 设置 左边 


距 ， 确 保 这 组 链接 位 于 屏幕 右边 。 


全 处 的 if 代码 块 与 以 前 使 用 的 条 件 代 码 块 相同 ， 它 
根据 用 户 是 否 已 登录 显示 相应 的 消息 。 这 个 代码 块 比 
以 前 发 一 i 因为 它 现 在 包含 一 些 样式 规则 。 和 个 处 是 
一 个 <span> 元 素 ， 用 于 设置 区 域内 一 系列 文本 或 元 
素 的 样式 。 这 起 初 可 能 令 人 迷惑 : 为 什么 不 藤 

套 <div> 呢 ? 毕 竟 有 很 多 页 面 深度 组 套 了 <div> 元 
En 这 是 因为 cdivy 元 素 创 建 区 域 ， 而 <spany> 元 素 
不 会 。 这 里 只 是 要 设置 导航 栏 中 信息 性 文本 《〈 如 已 登 
录用 户 的 名 称 ) 的 样式 ， 旨 在 让 其 外 观 与 链接 不 同 ， 
以 免 用 户 忍 不 住 去 单 击 ， 因 此 使 用 了 <spany> 。 


四 处 指出 <divy> 元 素 〈 它 包含 将 在 屏幕 太 罕 时 折 县 起 
来 的 导航 栏 部 分 ) 到 此 结束 ， 然 后 指出 整个 导航 栏 到 
此 结束 。 要 在 导航 栏 中 添加 其 他 链接 ， 可 在 既 有 的 
cul> 元 来 中江 加 cli> 元 素 ， 并 使 用 这 里 演示 的 样式 
设 


在 base.html 中 ， 还 需 添加 一 些 代码 : 定义 两 个 岂 ， 供 
各 个 页 面 放置 其 特有 的 内 容 。 


. 定义 页 面 的 主要 部 分 
base.html 的 余下 部 分 包含 页 面 的 主要 部 分 : 


base.html 


--Snip-- 
</nav> 


@ <main role="main" class="container"> 
@ <div class="pb-2 mb-2 border-bottom"> 
{% block page header %}{% endblock page_header 
</div> 
© <div> 
{% block content %}{% endblock content %} 
</div> 
</main> 


</body> 


</html> 


@@ 处 是 一 个 cmain> 起 始 标 签 。<main> 元 素 用 于 定义 
页 面 主 体 的 最 重要 部 分 。 此 处 指定 了 Bootstrap 选 择 


器 Container ， 这 是 一 种 对 页 面 元 素 进行 编组 的 简单 
方式 。 我 们 将 在 这 个 容器 中 放置 两 个 <div> 元 素 。 


第 一 个 <div> 元 素 〈 见 外) 包含 一 个 page_header 
块 ， 我 们 会 在 大 多 数 页 面 中 使 用 它 来 指定 标题 。 为 突 
出 标题 ， 设 置 内 边 距 。 内 边 距 〈padding) 指 的 是 元 
素 内 容 和 边框 之 间 的 距离 。 选 择 器 pb-2 是 一 个 
Bootstrap 指 令 ， 将 元 素 的 下 内 边 距 设置 为 适度 的 值 。 
外 边 距 (margin〉 指 的 是 元 素 的 边框 与 其 他 元 素 之 间 
的 距离 。 我 们 只 想 在 标题 下 面 添加 边框 ， 因 此 使 用 选 
择 器 border-bottom ， 它 在 page_header 块 的 下 面 
添加 较 细 的 边框 。 


全 处 定义 了 另 一 个 <div> 元 素 ， 其 中 包含 content 
块 。 我 们 没有 对 这 个 块 指定 样式 ， 因 此 在 具体 的 页 面 
中 ， 可 根据 需要 设置 内 容 的 样式 。 文 件 base.html 的 末 
尾 是 元 素 <main> 、<body> 和 <html> 的 结束 标签 。 


如 琳 现 在 在 浏览 希 中 加 载 “学 习 笔 记 ? 的 主页 ， 你 将 看 
到 一 个 类 似 于 图 20-1 所 示 的 专业 级 导航 栏 。 请 答 试 将 
窗口 调整 得 非常 奉 ， 此 时 导航 栏 将 变 成 一 个 按钮 。 如 
朵 你 单 击 这 个 按钮 ， 将 打开 一 个 下 拉 列 表 ， 其 中 包含 
所 有 的 导航 链接 。 


20.1.4 使 用 jumbotron 设 置 主页 的 样式 


下 面 使 用 Bootstrap 元 素 jumbotron 来 修改 主页 。 
jumbotron 元 素 是 一 个 大 框 ， 在 页 面 中 显得 智 立 鸡 群 。 
它 可 以 包含 任何 东西 ， 通 常用 于 在 主页 中 呈现 简要 的 
项 目 描述 和 让 用 户 行动 起 来 的 元 素 。 


修改 后 的 文件 index.html 如 下 所 示 : 
index.html 


{% extends "learning logs/base.html" %} 


@ {% block page header %} 
<div class="jumbotron"> 
<h1 class="display-3">Track your learning.</h1> 


<p class="lead">Make your own Learning Log, and kg 
topics you're learning about. Whenever you le 
about a topic, make an entry summarizing what 


<a class="btn btn-lg btn-primary”" href="{% url ‘ug 
role="button">Register &raquo;</a> 
</div> 
@ {% endblock page header %} 


在 @ 处 ， 告 诉 Django 接 下 来 要 定义 page_header 块 
包含 的 内 容 。jumbotron 束 是 应 用 了 一 系列 样式 设置 指 
令 的 <divy> 元 素 〈 见 人 @) 。 这 里 使 用 选择 

器 jumbotron 应 用 这 组 来 自 Bootstrap 库 的 样式 设置 指 
人 


Xo 


这 个 jumbotron 包 含 三 个 元 素 。 第 一 个 是 一 条 简短 的 消 
已 Track your learning， 让 首次 访问 者 大 致知 
道 “ 学 习 笔 记 ” 是 做 什么 用 的 。h1 类 表示 一 级 标题 ， 
而 选择 器 display-3 让 这 个 标题 显得 更 窗 更 高 〈 见 
和 全) 。 在 四 处 添加 一 条 更 长 的 消息 ， 让 用 户 更 详细 地 
知道 使 用 学 习 笔 记 可 以 做 什么 。 


在 加 处 ， 通 过 创建 一 个 按钮 〈 而 不 是 文本 链接 ) 邀请 
用 户 注册 账户 。 它 与 导航 栏 中 的 链接 Register 一 样 链 

接 到 的 注册 页 面 ， 但 是 按钮 更 显眼 ， 并 且 让 用 户 知道 
要 使 用 这 个 项 目 首 先 需要 如 何 做 。 这 里 的 选择 器 让 这 
个 按钮 很 大 ， 召 唤 用 户 赶 快 行动 起 来 。 代 人 码 &raquo; 
是 一 个 HTML 实 体 ， 表 示 两 个 右 尖 括号 (>> ) 。 在 
@@ 处 ， 结 束 page_header 块 。 我 们 不 想 在 这 个 页 面 


中 添加 其 他 内 容 ， 因 此 不 需要 定义 content 块 。 


0 比 设置 样式 前 有 很 大 
改进 。 


20.1.5 ”设置 登录 页 面 的 样式 
我 们 改进 了 登录 页 面 的 整体 外 观 ， 但 还 未 改进 登录 表 


单 。 下 面 来 修改 文件 login.html， 让 表单 与 页 面 的 其 他 
部 分 一 致 : 


login.html 


{% extends "learning logs/base.html" %} 
@ {% load bootstrap4 %} 


@ {% block page header %} 
<h2>Log in to your account.</h2> 
{% endblock page header %} 


{% block content %} 
<form method="post" action="{% url 'users:login' %}" 
{% csrf token %} 
{% bootstrap form form %} 
{% buttons %} 
<button name="submit" class="btn btn-primary">Ld 
{% endbuttons %} 


<input type="hidden" name="next" 
value="{% url 'learning logs:index' %}" /> 
</form> 


{% endblock content %} 


在 @ 处 ， 我 们 在 这 个 模板 中 加 载 bootstrap4 模 板 标 

签 。 在 四 处 ， 定 义 page_header 块 ， 指 出 这 个 页 面 

是 做 什么 用 的 。 注 意 ， 我 们 从 这 个 模板 中 删除 了 代码 
块 {% if form.errors %} ， 因 为 django-bootstrap4 
会 目 动 管理 表单 错误 。 


在 全 处 ， 添 加 属性 class="form" ， 再 使 用 模板 标签 
{% bootstrap_form %} 来 显示 表单 〈 见 四 ) ， 写 
替换 了 第 19 章 使 用 的 标签 {{ form.as_p }}+ 。 模 板 
标签 {% booststrap_ form %} 将 Bootstrap 样 式 规则 
应 用 于 各 个 表单 元 素 。 全 处 是 bootstrap4 起 始 模 板 标 
签 {% buttons %} ， 它 将 Bootstrap 样 式 应 用 于 按 
钮 。 


图 20-2 显 示 了 现在 演 染 的 登录 表单 。 这 个 页 面 比 以 前 
整洁 得 多 ， 且 风格 一 致 、 用 途 明确 。 如 有 果 你 答 试 使 用 
错误 的 用 户 名 或 密码 登录 ， 将 发 现 消 息 的 样式 与 整个 
网 站 一 致 ， 完 美 地 融入 了 进来 。 


图 < 加 localhost i @ 用 自用 己 


Learning Log Topics Register Log in 


Log in to your account. 


图 20-2 使 用 Bootstrap 设 置 样式 后 的 登录 页 面 
20.1.6 ”设置 显示 所 有 主题 的 页 面 的 样式 


下 面 来 确保 用 于 查看 信息 的 页 面 也 有 合适 的 样式 ， 首 
先 来 设置 显示 所 有 主题 的 页 面 : 


topics.html 


{% extends "learning logs/base.html" %} 


@ {% block page header %} 
<h1>Topics</h1> 
{% endblock page_header %} 


{% block content %} 
<ul> 
{% for topic in topics %} 
@ <1i><h3> 
<a href="{% Url 'learning logs:topic' topic.i 
</h3></1i> 
{% empty %} 
<1i><h3>No topics have been added yet.</h3></1i 
{% endfor %} 
</ul> 


日 <h3><a href="{% url 'learning logs:new topic' %}">A 
{% endblock content %} 


不 需要 标签 {% load bootstrap4 %} ， 因 为 这 个 文 
件 中 没有 使 用 任何 bootstrap4 自 定义 标签 。 我 们 将 标 
题 Topics 移 到 page_header 块 中 ， 并 给 它 指定 标题 样 
式 ， 而 没有 使 用 简单 的 段落 标签 ( 见 @)，。 将 每 个 主 
题 都 设置 为 <h3> 元 素 ， 使 其 在 页 面 上 显得 大 一 些 
0 。 对 于 添加 新 主题 的 链接 ， 也 做 同样 的 处 理 
( 见 @) 。 


20.1.7 设置 显示 单个 主题 的 页 面 中 的 条 目 样 
起 


比 起 大 部 分 页 面 ， 显示 年 个 主题 的 页 面包 合 时 多 站 
容 ， 因 此 需要 做 的 样式 设置 工作 要 更 多 一 些 。 我 们 将 
使 用 Bootstrap 的 卡片 (card) J 
EE 片 是 市 灵活 的 预定 义 样 式 的 <div> ， 非 常 适合 用 
于 显示 主题 的 条 目 : 


topic.html 


{% extends 'learning logs/base.html' %} 


@ {% block page header %} 
<h3>{{ topic }}</h3> 
{% endblock page_ header %} 


{% _ block content %} 
<p> 
<a href="{% url 'learning logs:new entry' topic.i 
</p> 


{% for entry in entries %} 
@ <div class="card mb-3"> 
日 <h4 class= "card-header "> 
{{ entry.date added|date:'Md，YH:i' }} 
@ <small><a href="{% url 'learning logs:edit entr 
edit entry</a></small> 
</h4> 
© <div class="card-body"> 
{{ entry.text|linebreaks }} 
</div> 
</div> 
{% empty %} 
<p>There are no entries for this topic yet.</p> 
{% endfor %} 


{% endblock content %} 


首先 将 主题 放 在 page_header 块 中 ( 见 @)， ， 并 删 
除 该 模板 中 以 前 使 用 的 无 序列 表 结 构 。 在 全 处 ， 创 建 


-个 带 选择 器 card 的 <div> 元 素 〈 而 不 是 将 每 个 条 
目 作 为 一 个 列表 项 ) ， 其 中 包含 两 个 藤 套 的 元 素 : 一 
个 包含 条 目的 创建 日 期 以 及 用 于 编辑 条 目的 链接 ， 田 
一 个 包含 条 目的 内 容 。 


和 藤 套 的 第 一 个 元 素 是 个 标题 。 它 是 带 选 择 器 card- 
header 的 <h4> 元 素 〈 见 全 ) ， 包 含 条 目的 创建 日 期 
以 及 用 于 编辑 条 目的 链接 。 用 于 编辑 条 目的 链接 放 在 
标签 csmall> 内 ， 这 让 它 看 起 来 比 时 间 惟 小 一 些 〈 见 
四 ) 。 第 二 个 髓 套 的 元 素 是 一 个 带 选 择 器 card-body 
的 <div> 元 素 〈( 见 人 @) ， 将 条 目的 内 容 放 在 一 个 简单 
的 框 内 。 注 意 我 们 只 修改 了 影响 页 面 外 观 的 元 素 ， 对 
在 页 面 中 包含 信息 的 Django 代 码 未 做 任何 修改 。 


图 20-3 显 示 了 修改 后 的 单个 主题 页 面 。“ 学 习 笔 记 ” 的 
功能 没有 任何 变化 ， 但 显得 更 专业 ， 对 用 户 更 有 吸引 


2 


的 localhost:8000/topics/1/ 
Learning Log Topics 
Chess 
Add new entry 
Feb 19, 2019 07:07 edit entry 


The bishops and knights are good pieces to have out in the opening phase of the game. They're both powerful enough to 
be useful in attacking your opponent, but not so powerful that you can't afford to lose them in an early ti 


Feb 19, 2019 02:06 edit entry 
In the openi eb of the game, it's importan ritelbrin ing ou yeu r bishops and knights. These pieces are powerful and 
an 


ough to play a significant role in the beginning moves of a game. 


Feb 19, 2019 02:06 edit entry 


The opening is the first part of the game, roughly the first ten moves or so. In the opening, it's a good idea to do three 


things 一 bring out your bishops and knights, try to control the center of the board, and castle your king. 


Of cnurse these are i uidalines it will he imnortant tn learn wh n fnllnw the idelines and when tn disrenarr 


图 20-3 i 


注意 ”要 使 用 其 他 Bootstrap 模 板 ， 可 采用 与 本 章 
类 似 的 流程 : 将 要 使 用 的 模板 复制 到 base.html 中 
并 修改 包含 实际 内 容 的 元 素 ， 以 使 用 该 模板 来 显 
示 项 目的 信息 ， 然 后 使 用 Bootstrap 的 样式 设置 工 
有 具 来 设置 各 个 页 面 中 内 容 的 样式 。 


二 

练习 20-1: 其 他 表单 ”本 节 对 登录 页 面 应 用 了 
Bootstrap 样 式 。 请 对 其 他 基于 表单 的 页 面 做 类 似 
的 修改 ， 包 括 new_topic 页 面 、new_entry 页 
面 、edit_entry 页 面 和 注册 页 面 。 


练习 20-2: 设置 博客 的 样式 ”对 于 你 在 第 19 章 
创建 的 项 目 Blog， 使 用 Bootstrap 来 设置 其 样式 。 


20.2 ”部署 “学 习 笔 记 ” 


至 此 ， 项 目 “ 学 习 笔记 ”的 外 观 显 得 很 专业 ， 下 面 将 其 
部 悍 到 服务 器 ， 让 任何 有 互联 网 连接 的 人 都 能 够 使 用 
它 。 为 此 ， 我 们 将 使 用 Heroku。 这 是 一 个 基于 Web 的 
平台 ， 供 我 们 管理 Web 应 用 程序 的 部 署 。 我 们 将 

让 “学 习 笔 记 ” 在 Heroku 上 运行 起 来 。 


20.2.1 建立 Heroku 账 户 


要 建立 账户 ， 请 访问 Heroku 官 方 网 站 ， 并 单 击 其 中 一 
个 注册 链接 。 注 册 账 户 是 免费 的 ，Heroku 提 供 的 免费 
试用 服务 (free tier) 让 你 能 够 将 项 目 部 署 到 服务 器 并 
对 其 进行 测试 。 


注意 ”Heroku 提 供 的 免费 试用 服务 存在 一 些 限 
制 ， 如 可 部 署 的 应 用 程序 数量 以 及 用 户 访问 应 用 
程序 的 频率 。 但 这 些 限制 都 很 宽松 ， 让 你 能 够 在 
不 文 付 任何 费用 的 情况 下 练习 部 署 应 用 程序 。 


20.2.2 ”安装 Heroku CLI 
要 将 项 目 部 署 到 Heroku 的 服务 器 并 对 其 进行 管理 ， 需 


要 使 用 Heroku CLI (Command Line Interface， 命 令 行 
界面 ) 提供 的 工具 。 要 安装 最 新 的 Heroku CLI 版 本 ， 
请 访问 Heroku Dev Center 网 站 的 The Heroku CLI 页 
面 ， 并 根据 你 使 用 的 操作 系统 按 相 关 的 说 明 做 : 使 用 
只 包含 一 行 的 终端 命令 或 下 载 并 运行 安装 程序 。 


20.2.3 ”安装 必要 的 包 
我 们 还 需 安 装 三 个 包 ， 以 便 在 服务 器 上 支持 Django 项 
目 提 供 的 服务 。 为 此 ， 在 活动 状态 的 虚拟 环境 中 执行 


WT ns 


(11_env)learning log$ pip install psycopg2==2.7.* 


(11_env)learning log$ pip install django-heroku 
(11_env)learning log$ pip install gunicorn 


为 管理 Heroku 使 用 的 数据 库 ，psycopg2 包 必 不 可 
少 。django-heroku 包 用 于 管理 应 用 程序 的 各 种 配 
置 ， 使 其 能 够 在 Heroku 服 务 器 上 正确 地 运行 。 这 包括 
管理 数据 库 ， 以 及 将 静态 文件 存储 到 合适 的 地 方 ， 以 
便 和 E 够 妥善 地 提供 它们 。 静 态 文件 包括 样式 规则 和 
JavaScript 文 件 。gunicorn 包 让 服务 器 能 够 实时 地 文 
持 应 用 程序 。 


20.2.4 创建 文件 requirements.txt 


Heroku 需 要 知道 项 目 依赖 于 哪些 包 ， 因 此 我 们 使 用 
pip 生 成 一 个 文件 ， 在 其 中 列 出 这 些 包 。 同 样 ， 进 入 
活动 虚拟 环境 ， 并 执行 如 下 命令 : 


(11_env)learning log$ pip freeze > requirements .txt 


命令 freeze 让 pip 将 项 目 中 当前 安装 的 所 有 包 的 名 称 
都 写 入 文件 requirements.txt。 请 打开 文件 
requirements.txt， 碍 看 项 目 中 安装 的 包 及 其 版 本 : 


requirements.txt 


dj-database-url==0.5.6 
Django==2.2.6 
django-bootstrap4==0.60.7 
django-heroku==6.3.1 
gunicorn==19.9.6 


psycopg2==2.7.7 
pytz==2018 .9 
Sqlparse==0.2.4 
whitenoise==4.1.2 


“学 习 笔记 ”依赖 于 8 个 特定 版 本 的 包 ， 因 此 在 相应 的 
环境 中 才能 正确 地 运行 。 在 这 8 个 包 中 ， 有 4 个 是 我 们 
0 余下 的 4 个 是 作为 依赖 的 包 目 动 安装 


我 们 部 署 “ 学 习 笔 记 ” 时 ，Heroku 将 安装 
requirements.txt 列 出 的 所 有 包 ， 从 而 创建 一 个 环境 ， 
其 中 包含 在 本 地 使 用 的 所 有 包 。 有 鉴于 此 ， 我 们 可 以 
深信 在 部 署 到 Heroku 后 ， 项 目的 行为 将 与 在 本 地 系统 
上 完全 相同 。 当 你 在 自己 的 系统 上 开发 并 维护 各 种 项 
目 时 ， 这 将 是 一 个 巨大 的 优点 。 


注意 “如果 在 你 的 系统 中 ，requirements.txt 列 出 
请 保留 原来 的 版 


20.2.5 “指定 Python 版 本 


如 果 没 有 指定 Python 版 本 ，Heroku 将 使 用 其 当前 的 
Python 默认 版 本 。 下 面 来 确保 Heroku 使 用 我 们 使 用 的 
Python 版 本 。 为 此 ， 在 活动 状态 的 虚拟 环境 中 ， 执 行 


命令 python --version : 


(11_env)learning log$ python --version 
Python 3.7.2 


上 述 输出 表明 ， 我 使 用 的 是 Python 3.7.2。 请 在 
manage.py 所 在 的 文件 夹 中 新 建 一 个 名 为 runtime.txt 的 
文件 ， 并 在 其 中 输入 如 下 内 容 : 


runtime.txt 


python-3.7.2 


这 个 文件 应 只 包含 一 行内 容 ， 以 上 面 所 示 的 格式 指定 


你 使 用 的 Python 版 本 。 请 确保 输入 小 写 的 python ， 
人 再 输入 由 三 部 分 组 成 的 版 
写 。 


注意 “如果 出 现 错误 消息 ， 指 出 不 能 使 用 指定 
的 Python 版 本 ， 请 访问 Heroku Dev Center 网 站 的 
Language Support 页 面 ， 再 单 击 到 Specifying a 
Python Runtime 的 链接 。 浏 览 打开 的 文章 ， 了 解 
文 持 的 Python 版 本 ， 并 使 用 与 你 使 用 的 Python 路 
本 最 接近 的 版 本 。 


20.2.6 ”为 部 署 到 Heroku 而 修改 settings.py 


现在 需要 在 settings.py 末 尾 添 加 一 个 片段 ， 在 其 中 指 
定 一 些 Heroku 环 境 设置 : 


Settings.py 


--Snip-- 
# 我 的 设置 
LOGIN_URL = 'users:login’' 


# Heroku 设 置 
import django_heroku 
django_heroku.settings(locals()) 


这 里 导入 了 模块 django_heroku 并 调用 了 也 
数 settings() 。 这 个 函数 将 一 些 设置 修改 为 Heroku 
环境 要 求 的 值 。 


20.2.7 ”创建 启动 进程 的 Procfile 


Procfile 告诉 Heroku 应 该 启动 哪些 进程 ， 以 便 正确 地 

提供 项 目 需要 的 服务 。 请 将 这 个 只 包含 一 行 代码 的 文 
件 命名 为 Procfile 〈 首 字母 P 为 大 写 ) ， 但 不 指定 文件 

扩展 名 ， 再 将 其 保存 到 manage.py 所 在 的 目录 中 。 


Procfile 的 内 容 如 下 : 


Procfile 


web: gunicorn learning log.wsgi --log-file - 


这 行 代码 让 Heroku 将 Gunicorn 用 作 服 务 器 ， 并 使 用 
learning_log/wsgi.py 中 的 设置 来 启动 应 用 程序 。 标 识 
log-file 告诉 Heroku 应 将 哪些 类 型 的 事件 写 入 日 


20.2.8 ”使 用 Git 跟 踪 项 目 文件 


第 17 草 说 过 ，Git 是 一 个 版 本 控制 程序 ， 让 你 能 够 在 
每 次 成 功 实现 新 功能 后 都 拍摄 项 目 代 码 的 快照 。 无 论 
出 现 什么 问题 (如 实现 新 功能 时 不 小 心 引 入 了 

bug) ， 都 可 轻松 地 恢复 到 最 后 一 个 可 行 的 快照 。 
个 快照 都 称 为 提交 。 


使 用 Git 意 味 着 在 尝试 实现 新 功能 时 无 须 担心 破坏 项 
目 。 将 项 目 部 署 到 服务 器 时 ， 需 要 确保 部 蜀 的 是 可 行 
版 本 。 要 更 详细 地 了 解 Git 和 版 本 控制 ， 请 参阅 附录 
D。 


Qa， 安装 Git 


在 你 的 系统 中 ， 可 能 已 经 安装 了 Git。 要 确定 是 
否 安 装 了 Git， 可 打开 一 个 新 的 终端 窗口 ， 并 在 


其 中 执行 命令 git --version : 


(11_env)1learning_log$ git --version 
git version 2.17.6 


如 果 由 于 茶 种 原因 出 现 了 错误 消息 ， 请 参阅 附录 
DD 中 的 Git 安 闭 说 明 。 


B. 配置 Git 


Git 跟 踪 是 谁 修改 了 项 目 ， 即 便 项 目 由 一 个 人 开 
发 亦 如 此 。 为 进行 跟踪 ，Git 需 要 知道 你 的 用 户 
名 和 电子 邮箱 。 因 此 ， 你 必须 提供 用 户 名 ， 但 对 
于 练习 项 目 ， 可 以 编造 一 个 电子 邮箱 


(11_env)learning log$ git config --global user.name 
(11_env)learning log$ git config --global user.emai 


如 果 起 0 步 ， 首 次 提交 时 Git 将 提示 你 提 
供 这 些 信息 


Y 忽略 文件 


无 须 让 Git 跟 踩 项 目 中 的 每 个 文件 ， 因 此 我 们 让 
它 忽略 一 些 文件 。 在 manage.py 所 在 的 文件 来 中 
创建 一 个 名 为 .gitignore 的 文件 (请 注意 ， 这 个 文 
件 名 以 句点 打头 ， 且 不 包含 扩展 名 ) ， 并 在 其 中 
输入 如 下 代码 : 


.gitignore 


ll1 env/ 
_ pycache__/ 


*.sqlite3 


这 里 让 Git 忽 略 目 录 ]l_env， 因 为 随时 都 可 自动 重 
新 创建 它 。 还 指定 不 跟踪 目录 。 pycache ， 这 
个 目录 包 仿 Django 运行 .py 文件 时 自动 创建 的 .pyc 
文件 。 我 们 没有 跟踪 对 本 地 数据 库 的 修改 ， 因 为 
这 是 个 坏 习 惯 : 如 果 在 服务 器 上 使 用 的 是 


SQLite， 将 项 目 推送 到 服务 器 时 ， 可 能 会 不 小 心 
用 本 地 测试 数据 库 履 六 在 线 数据 库 。*.sqlite3 
让 Git 忽 略 所 有 扩展 名 为 .sqlite3 的 文件 。 


注意 “如果 你 使 用 的 是 macOS 系 统 ， 请 
将 .DS_Store 添加 到 文件 .gitignore 中 。 文 
件 .DS_Store 存 储 的 是 有 关 文 件 夹 设置 的 信 
妃 ， 与 这 个 项 目 一 点 关系 都 没有 。 


. 显示 隐藏 的 文件 


大 多 数 操作 系统 都 会 隐藏 名 称 以 句点 打头 的 文件 
和 文件 夹 ， 如 .gitignore。 当 你 打开 文件 浏览 喜 或 
在 诸如 Sublime Text 等 应 用 程序 中 打开 文件 时 ， 
默认 看 不 到 隐藏 的 文件 。 


不 过 作为 程序 员 ， 你 需要 看 到 它们 。 下 面 说 明了 
如 何 显示 隐藏 的 文件 。 


。 在 Windows 系 统 中 ， 打 开 资 源 管理 器 ， 再 打 
开 一 个 文件 夹 ， 如 Desktop。 单 击 标 签 
View( 查 看) ， 并 确保 选中 了 复 选 框 File 
name extensions (文件 扩展 名 ) 和 Hidden 
items (隐藏 的 项 目 )。 

在 macOS 系 统 中 ， 要 显示 隐藏 的 文件 和 文件 
夹 ， 可 在 文件 浏览 右 窗 口中 按 Command + 
Shift + . (句点) 。 

在 Ubuntu 等 Linux 系 统 中 ， 可 在 文件 浏览 
中 按 Ctrl + 
为 让 这 种 设置 为 永久 性 的 ， 可 打开 文件 浏览 
器 〈 如 Nautilus) ， 再 单 击 选项 标签 〈 以 三 
条 线 表 示 ) ， 并 选中 复 选 框 Show Hidden 
Files (显示 隐藏 的 文件 )。 


e. 提交 项目 


我 们 需要 为 "学习 笔记 ”初始 化 一 个 Git 仓 库 ， 将 所 
有 必要 的 文件 都 加 入 该 仓库 ， 并 提交 项 目的 初始 
状态 ， 如 下 所 示 : 


(11_env)learning log$ git init 

Initialized empty Git repository in /home/ehmatt 
(11_env)learning log$ git add . 
(11_env)learning log$ git commit -am "Ready for a 
[master (root-commit) 79fef72] Ready for deploymg 
45 files changed, 712 insertions(+) 

create mode 166644 .gitignore 

create mode 166644 Procfile 


--Snip-- 

create mode 166644 users/views.py 
(11_env)learning log$ git status 
On branch master 

nothing to commit, working tree clean 
(11_env)learning log$ 


在 @@ 处 ， 执 行 命令 git init ， 在 “学 习 笔 记 ” 所 

在 的 目录 中 初始 化 一 个 空仓 库 。 在 @ 处 ， 执 行 命 
令 git add . 〈 于 万 别 筷 了 这 个 句点 ) ， 将 未 被 
忽略 的 文件 都 加 入 这 个 仓库 。 在 全 处 ， 执 行 命令 
git commit -am commit message ， 其 中 的 标 
志 -a 让 Git 在 这 个 提交 中 包含 所 有 修改 过 的 文 

件 ， 而 标志 -m 让 Git 记 录 一 条 日 志 消 息 。 


在 全 处 ， 执 行 命令 git status ， 输 出 表明 当前 
位 于 分 支 master， 而 工作 树 是 干净 (dlean) 的 。 
每 当 要 将 项 目 推 送 到 Heroku 时 ， 我 们 都 希望 看 到 
这 样 的 状态 。 


20.2.9 ”推送 到 Heroku 


终于 可 以 将 项 目 推 送 到 Heroku 了。 在 活动 的 虚拟 环境 
中 ， 执 行 下 面 的 命令 : 


@ (11_env)learning_ log$ heroku login 
heroku: Press any key to open up the browser to login 
Logging in... done 
Logged in as ericQ@example.com 
@ (ll env)learning log$ heroku create 
Creating app... done, ( secret-lowlands-82594 
https://secret-lowlands-82594.herokuapp.com/ | 
https://git.heroku.com/secret-lowlands-82594.git 
©@ (ll] env)learning log$ git push heroku master 


--Snip-- 
remote: ----- > Launching... 
remote: Released v5 
@ remote: https://secret-lowlands-82594.herokuap 


remote: Verifying deploy... done. 

To https://git.heroku.com/secret-lowlands-82594.git 
* [new branch] master -> master 
(11_env)learning log$ 


首先 执行 命令 heroku login ， 这 将 打开 浏览 器 并 在 
其 中 显示 一 个 页 面 ， 让 你 能 够 登录 Heroku ( 见 @) 。 
然后 ， 让 Heroku 创 建 一 个 空 项 目 ( 见 信 ) 。Heroku 生 
成 的 项 目 名 由 两 个 单词 和 一 串 数 字 组 成 ， 但 以 后 可 修 
改 这 个 名 称 。 接 下 来 ， 执 行 命令 git push heroku 
master ( 见 人 全 ) ， 让 Git 将 项 目的 分 支 master 推 送 到 
Heroku 刚 才 创 建 的 仓库 中 。Heroku 将 使 用 这 些 文件 在 
其 服务 器 上 创建 项 目 。 人 @ 处 列 出 了 用 于 访问 这 个 项 目 
的 URL， 但 这 个 URL 和 项 目 名 都 是 可 以 修改 的 。 


执行 这 些 命令 后 ， 项 目 残部 获 好 了 了， 但 还 未 做 全 面 配 
置 。 为 核实 正确 地 局 动 了 服务 器 进 程 ， 请 执行 命令 


heroku ps : 


(11_env)learning log$ heroku ps 
@ Free dyno hours quota remaining this month: 456h 44m 
Free dyno usage for this app: 6h em (8%) 
For more information on dyno sleeping and how to upgr 
https://devcenter.heroku.com/articles/dyno-sleeping 
@ === web (Free): gunicorn learning log.wsgi --log-file 
web.1: up 2619/62/19 23:46:12 -0966 (~ 16m ago) 
(11_env)learning log$ 


| | 


输出 指出 了 在 接 下 来 的 一 个 月 内 ， 项 目 还 可 在 多 长 时 
间 内 处 于 活动 状态 ( 见 @) 。 编写 本 书 时 ，Heroku 人 允 
许 免 费 部 署 在 一 个 月 内 最 多 有 550 小 时 处 于 活动 状 
态 。 项 目的 活动 时 间 超 过 这 个 限制 后 ， 将 显示 标准 的 
服务 器 错误 页 面 ， 我 们 稍 后 将 定制 这 个 错误 页 面 。 在 
全 处 ， 我 们 发 现 启 动 了 Procfile 指 定 的 进程 。 


现在 ， 可 使 用 命令 heroku open 在 浏览 器 中 打开 这 
个 应 用 程序 了 : 


(11_env)learning log$ heroku open 
(11_env)learning log$ 


以 启动 浏览 器 并 输入 Heroku 告 诉 你 的 URL， 但 上 
命令 让 你 无 须 这 样 做 。 你 将 看 到 “学 习 笔 记 ” 的 主 


页 ， 其 样式 设置 正确 无 误 ， 但 还 无 法 使 用 这 个 应 用 程 
序 ， 因 为 尚未 建立 数据 库 。 


注意 “部署 到 Heroku 的 流程 会 不 断 变 化 。 如 果 
过 到 无 法 解决 的 问题 ， 请 通过 查看 Heroku 文 档 来 
获取 帮助 。 为 此 ， 可 访问 Heroku Dev Center 网 站 
首页 ， 单 击 Python， 再 单 击 到 Get Started with 
Python 或 Deploying Python and Django Apps on 
Heroku 的 链接 。 如 果 看 不 懂 这 些 文档 ， 请 参阅 附 
录 C 提 供 的 建议 。 


20.2.10 ”在 Heroku 上 建立 数据 库 


为 建立 在 线 数 据 库 ， 需 要 再 次 执行 命令 migrate ， 并 
应 用 在 开发 期 间 生成 的 所 有 迁移 。 要 对 Heroku 项 目 执 
行 Django 和 Python 命 令 ， 可 使 用 命令 heroku run 。 
下 面 演示 了 如 何 对 Heroku 部 署 执行 命令 migrate : 


@ (11_env)learning_log$g heroku run python manage.py nial 


@ Running "python manage.py migrate' on ®@ secret-lowlan 
--Snip-- 

© Running migrations : 
--Snip-- 
Applying learning logs.0661_ initial... OK 
Applying learning logs.68062 entry... OK 
Applying learning logs.6663 topic owner... OK 
Applying sessions.6661 initial... OK 

(11_env)learning log$ 


首先 执行 命令 heroku run python manage.py 
migrate ( 见 @) 。Heroku 随 后 创建 一 个 终端 会 话 来 
执行 命令 migrate ( 见 人 @) 。 在 全 处 ，Django 应 用 默 


认 迁 移 以 及 我 们 在 开 友 “学 习 笔记 ”期 间 生 成 的 迁移 。 


现在 如 果 访 问 这 个 部 车 的 应 用 程序 ， 将 能 够 像 在 本 地 
系统 上 一 样 使 用 它 ， 但 看 不 到 在 本 地 部 车 中 输入 的 任 
何 数据 (包括 超级 用 户 账户 ，， 因 为 它们 还 没有 被 复 
制 到 在 线 服 务 器 。 通 常 ， 不 将 本 地 数据 复制 到 在 线 部 
普 中 ， 因 为 本 地 数据 通 单 是 测试 数据 。 


你 可 分 享 “ 学 习 笔记 ”的 Heroku URL， 让 任何 人 都 可 使 
用 它 。 下 一 节 将 再 完成 几 个 任务 ， 以 结束 部 署 过 程 ， 
让 你 能 够 继续 开发 “学 习 笔记 ”。 


20.2.11 改进 Heroku 部 署 


本 节 将 通过 创建 超级 用 户 来 改进 部 普 ， 就 像 在 本 地 一 
样 。 我 们 还 将 让 这 个 项 目 更 安全 : 将 DEBUG 设置 

为 False ， 让 用 户 在 错误 消息 中 看 不 到 额外 的 信息 ， 
以 防 其 利用 这 些 信 息 来 攻击 服务 器 。 


oa. 在 Heroku 上 创建 超级 用 户 
我 们 知道 可 以 使 用 命令 heroku run 来 执行 一 次 
性 命令 ， 但 也 可 这 样 执行 命令 : 在 连接 到 Heroknu 


服务 器 的 情况 下 ， 使 用 命令 heroku run bash 
打开 Bash 终 端 会 话 。Bash 是 众多 Linux 终 端 运行 


的 语言 。 我 们 将 使 用 Bash 终 端 会 话 来 创建 超级 用 
户 ， 以 便 访 问 在 线 应 用 程序 的 管理 网 站 : 


(11_env)learning log$ heroku run bash 

Running 'bash' on ( secret-lowlands-82594... up, 
~$ 1s 

learning log learning logs manage.py Procfile red 
staticfiles users 


~ $ python manage.py createsuperuser 
Username (leave blank to use ' U47318'): 11 admi 
Email address: 


Password: 

Password (again): 

Superuser created successfully. 
~ $ exit 

exit 

(11_env)learning log$ 


在 @ 处 ， 执 行 命令 ls ， 以 查看 服务 器 上 有 哪些 
文件 和 目录 。 服 务 器 包含 的 文件 和 目录 应 与 本 地 
0 
文件 系统 。 


注意 “即便 使 用 的 是 windows 系 统 ， 也 应 使 
用 这 里 列 出 的 命令 (如 1s 而 不 是 dir ) ， 
因为 这 里 是 在 通过 远程 连接 运行 Linux 终 


在 全 处 ， 执 行 创建 超级 用 户 的 命令 ， 它 像 第 18 章 
在 本 地 系统 创建 超级 用 户 一 样 提示 你 输入 相关 的 
信息 。 在 这 个 终端 会 话 中 创建 超级 用 户 后 ， 执 行 
人 返回 到 本 地 系统 的 终端 会 话 〈 见 

bo 


现在 ， 你 可 以 在 在 线 应 用 程序 的 URL 末 尾 添 
加 /admin/ 来 登录 管理 网 站 了 。 对 我 而 言 ， 这 个 
URL 为 https://secret-lowlands- 
82594.herokuapp.com/admin/。 


如 采 有 其 他 人 使 用 这 个 项 目 ， 别 筷 了 你 能 访问 他 
们 的 所 有 数据 ! 干 万 列 不 把 这 一 点 当 回 事 ， 人 否则 
用 户 束 不 会 再 将 数据 托付 给 你 了 。 


B. 在 Heroku 上 创建 对 用 户 友好 的 URL 


你 很 可 能 希望 URL 更 友好 ， 比 https://secret- 
lowlands-82594.herokuapp.com/admin/ 更 好 记 。 为 
此 ， 只 需 使 用 一 个 命令 重 命名 应 用 程序 : 


(11_env)learning log$ heroku apps:rename learning- 
Renaming secret-lowlands-82594 to learning-log-2e. 
https://learning-log.herokuapp.com/ | https://git. 
Git remote heroku updated 


S Don't forget to update git remotes for all ot 
(11_env)learning log$ 


给 应 用 程序 命名 时 ， 可 使 用 字母 、 数 字 和 连 字 
符 ， 并 且 想 怎么 命名 都 可 以 ， 只 要 指定 的 名 称 未 
补 别 人 使 用 就 行 。 现 在 ， 项 目的 URL 变 成 了 
https://learning-log.herokuapp.com/。 使 用 以 前 的 
URL 再 也 无 法 访问 它 ， 命 令 apps :rename 将 整 
个 项 目 都 移 到 了 新 的 URL 处 。 


注意 “使 用 Heroku 提 供 的 免费 服务 部 署 项 

目 时 ， 如 果 项 目 在 指定 时 间 内 未 收 到 请 求 或 
过 于 活跃 ，Heroku 将 让 项 目 进入 休眠 状态 。 

用 户 访问 处 于 休眠 状态 的 网 站 时 ， 加 载 时 间 
将 更 长 ， 但 对 于 后 续 请 求 ， 服 务 器 的 啊 应 速 
度 将 更 快 。 这 就 是 Heroku 能 够 提供 免费 部 署 
的 原因 所在。 


20.2.12 ”确保 项 目的 安全 


当前 ， 部 署 的 项 目 存在 严重 的 安全 问题 ， settings.py 
含 设置 DEBUG=True ， 指 定 在 发 生 错误 时 显示 调试 


音 息 。 开 发 项 目 时 ，Django 的 错误 页 面 显示 了 重要 的 
调试 信息 ， 如 宋 将 项 目 部 车 到 服务 器 后 还 保留 这 个 设 
置 ， 将 给 攻击 者 提供 大 量 可 利用 的 信息 。 


在 在 线 项 目 中 ， 我 们 将 设置 一 个 环境 变量 ， 以 控制 是 
人 百 显 示 调 试 信息 。 坏 境 变 量 是 在 特定 环境 中 设置 的 
值 。 这 是 在 服务 器 上 存储 敏感 信息 并 将 其 与 项 目 代 码 
TY 


下 面 来 修改 settings.py， 使 其 在 项 目 于 Heroku 上 运行 
时 检查 一 个 环境 变量 : 


settings.py 


--Snip-- 

# Heroku 设 置 
import django_heroku 
django_heroku.settings(locals()) 


if os.environ.get('DEBUG') == 'TRUE': 
DEBUG = True 

elif os.environ.get('DEBUG') == “FALSE ' : 
DEBUG = False 


方法 os.environ.get() 从 项 目 当前 所 处 的 环境 中 读 
取 与 特定 环境 变量 相关 联 的 值 。 如 果 设 置 了 这 个 环境 
变量 ， 就 返回 它 的 值 ， 如 果 没 有 设置 ， 就 返回 None 
。 使 用 环境 变量 来 存储 布尔 值 时 ， 必 须 小 心 应 对 ， 因 
为 在 大 多 数 情 况 下 ， 环 境 变 量 存储 的 都 是 字符 串 。 请 
看 下 面 在 简单 的 Python 终 端 会 话 中 执行 的 代码 片段 : 


>>> bool('False') 
True 


字符 串 'False' 对 应 的 布尔 值 为 True ， 因 为 非 空 字 
符 串 对 应 的 布尔 值 都 为 True 。 因 此 ， 我 们 将 使 用 全 


大 写 的 字符 串 'TRUE' 和 'FALSE' ， 以 明确 地 指出 存 
储 的 不 是 Python 布尔 值 True 和 False 。Django 读 取 
Heroku 中 键 为 'DEBUG ' 的 环境 变量 时 ， 如 果 其 值 

为 "TRUE' ， 我 们 就 将 DEBUG 设置 为 True ; 如 果 其 值 
为 "FALSE' ， 就 将 DEBUG 设置 为 False 。 


20.2.13 ”提交 并 推送 修改 
现在 需要 将 对 settings.py 所 做 的 修改 提交 a 到 Git 仓 库 ， 


再 将 修改 推送 到 Heroku。 下 面 的 终端 会 话 演示 了 这 个 
过 程 : 


@ (ll env)learning log$ git commit -am "Set DEBUG based 
[master 3427244] Set DEBUG based on environment Varial 
1 file changed, 4 insertions(+) 

@ (ll env)learning log$ git status 


On branch master 
nothing to commit, working tree clean 
(11_env)learning log$ 


我 们 执行 命令 git commit ， 并 指定 一 条 简短 而 有 描 
述 性 的 提交 消息 ( 见 @) . 别 志 了， 标志 -am 让 Git 提 
交 所 有 修改 过 的 文件 ， 并 记录 一 条 日 志 消 息 。Git 找 
出 唯一 修改 过 的 文件 ， 并 将 所 做 的 修改 提交 到 仓库 。 


全 处 显示 的 状态 表明 ， 当 前 位 于 仓库 的 分 支 master， 
没有 任何 未 提交 的 修改 。 推 送 到 Heroku 前 ， 必 须 检查 
状态 并 看 到 刚才 所 说 的 消息 。 如 果 没 有 看 到 这 样 的 消 
妃 ， 就 说 明 有 未 提交 的 修改 ， 而 这 些 修 改 将 不 会 推送 
到 服务 器 。 在 这 种 情况 下 ， 可 尝试 再 次 执行 命令 
commit ， 但 如 果 你 不 知道 该 如 何 解决 这 个 问题 ， 请 
阅读 附录 D， 更 深入 地 了 解 Git 的 用 法 。 


下 面 将 修改 后 的 仓库 推送 到 Heroku: 


(11_env)learning log$ git push heroku master 
remote: Building source: 
remote: 


remote: ----- > Python app detected 


remote: ----- > Installing requirements with pip 
--Snip-- 

remote: ----- > Launching... 

remote: Released v6 

remote: https://learning-log.herokuapp.com/ depl 
remote: 


remote: Verifying deploy... done. 

To https://git.heroku.com/learning-log.git 
144f626. .d5675a1 master -> master 

(11_env)learning log$ 


Heroku 发 现 仓库 及 生 了 变化 ， 因 此 重建 项 目 ， 确 保 所 
有 的 修改 部 生效 。 它 不 会 重建 数据 库 ， 因 此 这 次 无 须 


执行 命令 migrate 。 


20.2.14 在 Heroku 上 设置 环境 变量 


现在 可 通过 Heroku 将 settings.py 中 的 DEBUG 设置 为 所 
需 的 值 了 。 


命令 heroku config:set 设置 一 个 环境 变量 : 


(1l1_env)learning log$ heroku config:set DEBUG=FALSE 
Setting DEBUG and restarting @ learning-log... done, v7 
DEBUG: FALSE 


(11_env)learning log$ 


每 当 你 在 Heroku 上 设置 环境 变量 时 ，Heroku 都 将 重启 
项 目 ， 让 环境 变量 生效 。 


要 核实 部 蓟 现在 更 安全 了 ， 请 输入 项 目的 URL， 并 在 
末尾 加 上 未 定义 的 路 径 ， 如 答 试 访问 http: 人 
log.herokuapp.com/letmein。 你 将 看 到 通用 的 错误 页 
面 ， 它 没有 泄露 任何 有 关 该 项 目的 具体 信息 。 如 果 通 
0 http://localhost:8000/letmein/ 向 本 地 的 “学 
笔记 ”发 出 同样 的 请 求 ， 你 将 看 到 完整 的 Django 错 


误 页 面 。 这 样 的 结果 非常 理想 ; 接着 开发 这 个 项 目 
时 ， 你 可 以 看 到 信息 丰富 的 错误 消息 ， 但 访问 在 线 项 
目的 用 户 看 不 到 有 关 代码 的 重要 信息 。 


如 果 你 在 部 署 应 用 程序 时 册 到 麻烦 ， 需 要 排除 故障 ， 
可 执行 命令 heroku config:set DEBUG='TRUE' 

以 便 访 问 在 线 项 目 时 能 够 看 到 完整 的 错误 报告 。 成 功 
地 排除 故 隐 后 ， 务 必 将 这 个 环境 变量 重 置 为 "FALSE 
。 男 外 ， 请 务必 小 心 ， 一 旦 有 用 户 经 常 访 问 这 个 在 线 
项 目 ， 就 不 要 这 样 做 。 


20.2.15 ”创建 目 定 义 错误 页 面 


第 19 章 对 “学 习 笔 记 ” 进 行 了 配置 ， 使 其 在 用 户 请 求 不 
属于 自己 的 主题 或 条 目 时 返回 404 错 误 。 你 可 能 还 遇 
到 过 一 些 500 错 误 〈 内 部 错误 ) 。404 错 误 通 常 意味 着 
Django 代 码 是 正确 的 ， 但 请 求 的 对 象 不 存在 。500 错 
误 通 营 意 味 着 代码 有 问题 ， 如 views.py 中 的 函数 有 问 
题 。 当 前 ， 在 这 两 种 情况 下 ，Django 都 返回 通用 的 错 
误 页 面 ， 但 我 们 可 以 编写 外 观 与 “学 习 笔 记 ” 一 致 的 
ee 音 误 页 面 模板 。 这 些 模板 必须 放 在 根 模板 目 


Qa. 创建 目 定义 模板 


在 最 外 层 的 文件 夹 learning_log 中 ， 新 建 一 个 文件 
来， 并 将 其 命名 为 templates。 然 后 在 这 个 文件 夹 
中 新 建 一 个 名 为 404.html 的 文件 (这 个 文件 的 路 
径 应 为 learning_log/templates/404.html) ， 并 在 其 
中 输入 如 下 内 容 : 


404.html 


{% extends "learning logs/base.html" %} 


{% block page_header %} 
<h2>The item you requested is not available. (46 
{% endblock page_header %} 


[L 


个 简单 的 模板 指定 了 通用 的 404 错 误 页 面包 含 
的 信和 但 该 页 面 的 外 观 与 网 站 其 他 部 分 一 
至 


再 创建 一 个 名 为 500.html 的 文件 ， 并 在 其 中 输入 
如 下 代码 : 


500.html 


{% extends "learning logs/base.html" %} 


{% block page_header %} 
<h2>There has been an internal error. (560)</h2> 
{% endblock page header %} 


这 些 新 文件 要 求 对 settings.py 做 细微 的 修改 : 
settings.py 


--Snip-- 
TEMPLATES 
{ 
"BACKEND ' : 'django.template.backends.djangd 
'DIRS': [os.path.join(BASE DIR, "templates ， 
"APP_DIRS': True, 
--Snip-- 


}, 


] 


--Snip-- 


人 乍 根 模板 目录 中 和 查找 错误 页 面 
蝎 


B. 在 本 地 查看 错误 页 面 


将 项 目 推送 到 Heroku 前 ， 如 果 要 在 本 地 查看 错误 
页 面 是 什么 样 的 ， 首 先 需要 在 本 地 设置 中 设 

置 Debug=False ， 以 禁止 显示 默认 的 Django 调 
试 页 面 。 为 此 ， 可 对 settings.py 做 如 下 修改 〈 请 
确保 修改 的 是 settings.py 中 用 于 本 地 环境 的 部 

分 ， 而 不 是 用 于 Heroku 的 部 分 ) : 


Settings.py 


--Snip-- 
# 安全 警告 : 不 要 在 在 线 环 境 中 启用 调试 ! 
DEBUG = False 


--Snip-- 


现在 ， 请 求 不 属于 你 的 主题 或 条 目 ， 以 查看 404 
音 误 页 面 。 然 后 请 求 不 存在 的 主题 或 条 目 ， 以 得 
看 500 错 误 页 面 。 例 如 ， 如 果 输 入 
http://localhost:8000/topics/999/， 将 出 现 500 错 误 
页 面 ， 除 非 你 输入 的 主题 已 经 超过 了 999 个 ! 


查看 错误 页 面 后 ， 将 本 地 DEBUG 的 值 重 新 设置 
为 True ， 为 后 续 开 发 提供 方便 。〈 在 管理 
Heroku 设 置 的 部 分 ， 确 保 处 理 DEBUG 的 方式 不 
变 。) 


注意 。 500 错误 页 面 不 会 显示 任何 有 关 当 前 
用 户 的 信息 ， 因 为 发 生 服务 器 错误 时 ， 
Django 不 会 通过 啊 应 发 送 任何 上 下 文 信息 。 


.将 修改 推送 到 Heroku 


现在 需要 提交 对 错误 页 面 所 做 的 修改 ， 并 将 这 些 
修改 推送 到 Heroku: 


@ (ll] env)learning log$ git add . 


@ (1]1_env)learning log$ git commit -am "Added cust 
3 files changed，15 insertions(+)，16 deletions 
create mode 166644 templates/4064.html 
create mode 166644 temp1lates/566 .html] 

©@ (1]1_env)learning_ log$ git push heroku master 

--Snip-- 

remote: Verifying deploy.... done. 

To https://git.heroku.com/learning-log.git 
d5675a1. .4bd3b1c master -> master 

(11_env)learning log$ 


在 @ 处 ， 执 行 命令 git add . ， 因 为 我 们 在 项 目 
中 创建 了 一 些 新 文件 ， 需 要 让 Git 跟 踪 它 们 。 然 
后 ， 提 交 所 做 的 修改 〈 见 @) ， 并 将 修改 后 的 项 
目 推 送 到 Heroku ( 见 @@) 。 


现在 ， 错 误 页 面 出 现时 ， 其 样式 应 该 与 网 站 其 他 
部 分 一 致 。 这 样 ， 在 发 生 错 误 时 ， 用 户 将 不 会 感 
到 别扭 。 


. 使 用 方法 get_object_or_464() 


现在 ， 如 果 用 户 手工 请 求 不 存在 的 主题 或 条 目 ， 
将 导致 500 错 误 。Dijango 尝 试 泻 染 不 存在 的 页 
面 ， 但 没有 足够 的 信息 来 完成 这 项 任务 ， 进 而 引 
发 了 500 错 误 。 对 于 这 种 情形 ， 将 其 视 为 404 错 误 
更 合适 。 为 此 可 使 用 Django 快 捷 函 

数 get_object_or_464() 。 这 个 函数 尝试 从 数 
据 库 获取 请 求 的 对 象 ， 如 果 这 个 对 象 不 存在 ， 就 
引发 404 异 常 。 我 们 在 views.py 中 导入 这 个 函数 ， 
并 用 它 蔡 换 函 数 get() : 


views.py 


from django.shortcuts import render, redirect, get 
from django.contrib.auth.decorators import login_r 


--Snip-- 
@login required 


def topic(request, topic id) : 
'"" 显 示 单 个 主题 及 其 所 有 的 和 条目。 """ 
topic = get object or 464(Topic，id=topic id) 
# 确定 主题 属于 当前 用 户 。 


--Snip-- 


现在 ， 如 果 请 求 不 存在 的 主题 (如 使 用 URL 
http://localhost:8000/topics/999/) ， 将 看 到 404 错 
误 页 面 。 为 部 署 这 里 所 做 的 修改 ， 再 次 提交 ， 并 
将 项 目 推送 到 Heroku。 


20.2.16 ”继续 开发 


将 项 目 “ 学 习 笔记 ”推送 到 服务 器 后 ， 你 可 能 想 进 一 步 
开发 它 或 开发 要 部 著 的 其 他 项 目 。 更 新 项 目的 过 程 几 
乎 完全 相同 。 


首先 ， 对 本 地 项 目 做 必要 的 修改 。 如 果 在 修改 过 程 中 
创建 了 新 文件 ， 使 用 命令 git add . ( 千 万 别 忘记 末 
尾 的 句点 ) 将 其 加 入 Git 仓 库 中 。 如 果 有 修改 要 求 迁 

移 数 据 库 ， 也 需要 执行 这 个 命令 ， 因 为 每 个 迁移 都 将 
生成 新 的 迁移 文件 。 


然后 ， 使 用 命令 git commit -am "commit 
message" 将 修改 提交 到 仓库 ， 再 使 用 命令 git push 
heroku master 将 修改 推送 到 Heroku。 如 果 在 本 地 
迁移 了 数据 库 ， 也 需要 迁移 在 线 数 据 库 。 为 此 ， 可 使 
用 一 次 性 命令 heroku run python manage.py 
migrate ， 也 可 使 用 heroku run bash 
庙会 话 ， 并 在 其 中 执行 命令 python manage.p 

然后 访问 在 线 项 目 ， 确认 期 望 看 到 的 修改 
已 生效 。 


在 这 个 过 程 中 很 容易 犯错 ， 因 此 看 到 错误 时 不 要 大 惊 
小 怪 。 如 果 代 码 不 能 正确 地 工作 ， 请 重新 审视 所 做 的 
全 兰 试 找 出 其 中 的 和 音 误 。 如 果 找 不 出 错误 ， 或 者 
不 知道 如 何 撤销 错误 ， 请 参阅 附录 C 中 有 关 如 何 寻 求 


帮助 的 建议 。 不 要 做 于 去 寻求 帮助 :每 个 学 习 开 友 项 
目的 人 都 可 能 过 到 过 你 面临 的 问题 ， 因 此 总 有 人 乐意 
伸 出 援手 。 通 过 解决 遇 到 的 每 个 问题 ， 可 让 你 的 技能 
稳步 提高 ， 最 终 能 够 开发 可 靠 而 有 意义 的 项 目 ， 还 能 
解决 别人 直到 的 问题 。 


20.2.17 设置 SECRET_KEY 


Django 根 据 settings.py 中 设置 SECRET_KEY 的 值 来 实现 
大 量 的 安全 协议 。 在 这 个 项 目 中 ， 提 交 到 仓库 的 设置 
文件 包含 设置 SECRET_KEY 。 对 于 一 个 练习 项 目 而 
言 ， 这 足够 了 ， 但 对 于 生产 网 站 ， 应 更 细致 地 处 理 设 
置 SECRET_KEY 。 如 果 你 创建 的 项 目的 用 途 很 重要 ， 
务必 研究 如 何 更 安全 地 处 理 设置 SECRET_KEY 。 


20.2.18 ”将 项 目 从 Heroku 删 除 


一 个 不 错 的 练习 是 ， 使 用 同一 个 项 目 或 一 系列 小 项 目 
执行 部 署 过 程 多 次 ， 直 到 对 部 团 过 程 了 如 指 掌 。 人 然 
而 ， 你 需要 知道 如 何 删 除 部 署 的 项 目 。Heroku 限 制 了 
可 免费 托管 的 项 目 数 ， 而 你 也 不 希望 自己 的 账户 中 包 
伟大 量 练习 项 目 。 


在 Heroku 网 站 登录 后 ， 将 重 定向 到 一 个 页 面 ， 其 中 列 
出 了 你 托管 的 所 有 项 目 。 单 击 要 删除 的 项 目 ， 你 将 看 
到 另 一 个 页 面 ， 其 中 显示 了 有 关 这 个 项 目的 信息 。 单 
击 链接 Settings， 再 向 下 滚动 ， 找 到 用 于 删除 项 目的 
链接 并 单 击 它 。 这 种 操作 是 不 可 撤销 的 ， 因 此 Heroku 
让 你 手工 输入 要 删除 的 项 目的 名 称 ， 确 认 你 确实 要 删 


从 


如 果 喜 欢 在 终端 中 工作 ， 也 可 使 用 命令 destroy 来 删 
除 项 目 : 


(11_env)learning log$ heroku apps:destroy --app appname 


appname 是 要 删除 的 项 目的 名 称 ， 可 能 类 似 于 
secret-lowlands-82594 ， 也 可 能 类 似 于 
learning-1og 《如 果 你 重 命名 了 项 目 ) 。 你 将 被 要 
求 再 次 输入 项 目 名 ， 确 认 你 确实 要 删除 它 。 


注意 ”删除 Heroku 上 的 项 目 对 本 地 项 目 没 有 任 
何 影 响 。 如 果 没 有 人 使 用 你 部 署 的 项 目 ， 就 尽管 
去 练习 部 署 过 程 好 了 ， 在 Heroku 上 删除 项 目 再 重 
新 部 署 完全 合情合理 。 


动手 试 一 斌 


练习 20-3: 在 线 博 客 ”将 你 一 直 在 开发 的 项 目 
Blog 部 蜀 到 Heroku。 确 保 将 DEBUG 设置 为 False 
， 以 免 出 现 错误 时 用 户 看 到 完整 的 Django 错 误 页 
面 。 


练习 20-4: 在 更 多 的 情况 下 显示 404 错 误 页 面 
在 视图 函数 new_entry() 和 edit_entry() 中 ， 
也 使 用 函数 get_object_or 464() 。 完 成 这 些 
修改 后 进行 测试 : 输入 类 似 于 
http://localhost:8000/new_entry/999/ 的 URL， 确 认 
看 到 的 是 404 错 误 页 面 。 


练习 20-5: 扩展 “学 习 笔 记 ” 在 “学 习 笔 记 ” 中 添 
加 一 项 功能 ， 并 将 修改 推送 到 在 线 部 晋 。 演 试 做 
一 项 简单 的 修改 ， 如 在 主页 中 对 项 目 做 更 详细 的 
描述 。 再 答 试 添加 一 项 更 高 级 的 功能 ， 如 让 用 户 
能 够 将 主题 设置 为 公开 的 。 为 此 ， 需 要 在 模型 
Topic 中 添加 一 个 名 为 public 的 属性 (其 默认 
值 为 False ) ， 并 在 new_topic 页 面 中 添加 一 个 
表单 元 素 ， 让 用 户 能 够 将 私有 主题 改 为 公开 。 然 
后 ， 需 要 迁移 项 目 ， 并 修改 views.py， 让 未 登录 
的 用 户 也 可 以 看 到 所 有 公开 的 主题 。 将 修改 推送 
到 Heroku 后 ， 别 筷 了 迁移 在 线 数 据 库 。 


20.3 “小结 


在 本 章 中 ， 你 学 习 了 如 何 使 用 Bootstrap 库 和 应 用 程序 
django-bootstrap4 赋 予 应 用 程序 简单 而 专业 的 外 观 。 
使 用 Bootstrap 意 味 着 无 论 用 户 使 用 哪 种 设备 来 访问 你 
的 项 目 ， 你 选择 的 样式 都 将 实现 几乎 相同 的 效果 。 


你 学 习 了 Bootstrap 的 模板 ， 并 使 用 模板 Navbar static 赋 
予 了 “学 习 笔记 ”简单 的 外 观 。 你 学 习 了 如 何 使 用 
jumbotron 来 突出 主页 中 的 消息 ， 还 学 习 了 如 何 给 网 站 
的 所 有 页 面 设置 一 致 的 样式 。 


在 本 章 最 后 一 节 ， 你 学 习 了 如 何 将 项 目 部 署 到 Heroku 
服务 器 ， 让 任何 人 都 能 够 访问 。 你 创建 了 一 个 Heroku 
账户 ， 并 安装 了 一 些 帮助 管理 部 署 过 程 的 工具 。 你 使 
用 Git 将 能 够 正确 运行 的 项 目 提交 到 仓库 ， 再 将 这 个 
仓库 推送 到 Heroku 的 服务 器 。 最 后 ， 你 将 DEBUG 设置 
为 False ， 以 确保 在 线 应 用 程序 的 安全 。 


开发 完 项 目 “ 学 习 笔 记 ? 后 ， 你 就 能 自己 动手 开发 项 目 
了 。 请 移 让 项 目 尽 可 能 简单 ， 确 定 它 能 正确 运行 后 ， 
再 添加 复杂 的 功能 。 愿 你 学 习 愉 快 ， 开 发 项 目 时 有 好 
运 相伴 ! 


附录 A ” 安 站 与 故障 排除 


Python 有 不 同 的 版 本 ， 在 各 种 操作 系 
统 中 有 很 多 安装 方式 ， 如 果 第 1 章 介 绍 的 方式 不 
管用 ， 或 者 要 安装 非 系统 上 自 带 的 Python 版 本 ， 本 
附录 可 提供 帮助 。 


A.1 Windows 系 统 


第 1 章 的 安装 说 明 指 出 了 如 何 使 用 Python 网 站 提供 的 
官方 安装 程序 安装 Python。 如 果 执 行 安装 程序 后 ， 无 
法 运行 Python， 本 节 的 故障 排除 说 明 将 帮助 你 让 
Python 恢 复 正常 。 


A.1.1 查找 Python 解释 器 


如 果 执 行 简单 命令 python 时 出 现 错 误 消 息 ， 如 
python 不 是 可 识别 的 内 部 或 外 部 命令 〈python is not 
recognized as an internal or external command) ， 很 可 
能 是 因为 执行 安装 程序 时 没有 选中 复 选 框 Add Python 
to PATH。 在 这 种 情况 下 ， 需 要 告诉 Windows 去 哪里 
查找 Python 解 释 器 。 要 确定 Python 解 释 器 的 位 置 ， 请 
打开 C 盘 ， 并 在 其 中 和 查找 名 称 以 Python 打头 的 文件 
夹 。《 要 找到 这 样 的 文件 夹 ， 可 能 需要 在 Windows 资 
源 管 理 器 的 搜索 栏 中 输入 单词 python， 因 为 它 可 能 不 
在 C 盘 的 根 目 录 下 。) 打开 这 个 文件 夹 ， 并 得 找 名 称 
为 python 〈 全 部 小 写 ) 的 文件 。 右 击 这 个 文件 并 选 
择 “ 属 性 ?， 你 将 在 “位 置 ” 后 面 看 到 它 的 路 径 。 


要 告诉 Windows 去 哪里 查找 解释 器 ， 可 以 打开 一 个 终 
端 窗口 ， 输 入 刚才 看 到 的 路 径 ， 再 输入 -version ， 
并 按 回 车 键 : 


$ C:\Python37\python --version 
Python 3.7.2 


在 你 的 系统 中 ， 这 条 路 径 可 能 类 似 于 下 面 这 
样 : C:\Users\username\Programs\Python37\pyt 
。 指 定 路 径 后 ，Windows 应 该 会 运行 Python 解释 器 。 


A.1.2 ”将 Python 添加 到 环境 变量 Path 


如 果 每 次 月 动 Python 终端 会 话 时 都 需要 输入 完整 的 路 
径 ， 那 就 太 讨 大 了 。 因 此 ， 我 们 将 在 系统 中 添加 这 个 
路 径 ， 让 你 只 需 使 用 命令 python 即 可 。 打 开 控制 面 
板 并 单 击 “ 系 统 和 安全 ”， 再 单 击 “系统 ”。 单 击 “ 高 级 
系统 设置 "， 在 打开 的 窗口 中 单 击 按钮 “环境 变量 ”。 


在 “系统 变量 ”部 分 ， 找 到 并 单 击 变 量 Path ， 再 单 击 
按钮 “编辑 ”。 你 将 看 到 一 系列 位 置 ， 而 系统 将 在 这 些 
位 置 查 找 程序 。 单 击 “ 新 建 " 按 钮 ， 并 将 文件 
python.exe 的 路 径 粘贴 到 出 现 的 文本 框 中 。 如 果 你 的 
系统 设置 与 我 的 一 样 ， 这 条 路 径 应 该 是 这 样 的 : 


C:\Python37 


请 注意 ， 这 里 没有 指定 文件 名 python.exe， 而 只 是 
诉 系 统 到 哪里 去 查找 它 。 


关闭 终端 窗口 ， 再 打开 一 个 新 的 终端 窗口 。 这 将 在 终 
端 会 话 中 加 载 变量 path 的 新 值 。 现 在 执行 命令 
python --version 时 ， 你 将 看 到 刚才 在 变量 Path 
中 设置 的 Python 版 本 。 现 在 ， 只 需 在 命令 提示 符 下 输 
入 python 并 按 回 车 ， 束 可 局 动 Python 终端 会 话 了 。 


注意 如果 你 使 用 的 是 较 早 的 Windows 版 本 ， 则 
单 击 “编辑 ”按钮 和 时， 出 现 的 对 话 框 可 能 包含 文本 
框 “ 变 量 *"。 如 果 是 这 样 ， 请 使 用 右 第 头 键 深 动 到 
最 右边 。 干 万 不 要 和 窗 六 变 量 原来 的 值 。 如 果 不 小 
心 履 关 了 ， 请 单 击 “取消 ”按钮 ， 再 重复 前 面 的 步 
又 。 在 变量 值 的 末尾 添加 一 个 分 号 ， 再 添加 文件 
python.exe 的 路 径 ， 如 下 上 所 示 : 


%SystemRoot%\system32\...\System32\WindowsPowerShejl\ 


A.1.3 重 装 Python 


ly 


如 果 还 是 无 法 运行 Python， 旬 载 Python 并 再 次 执行 安 
装 程 序 通 党 能 解决 所 有 的 问题 。 为 此 ， 打 开 “ 控 制 面 
板 ” 并 单 击 “程序 和 功能 "再 同 下 深 动 ， 找 到 并 选择 
刚才 安装 的 Python 版 本 。 单 击 “ 印 载 /更 改 ”， 在 出 现 的 
对 话 框 中 单 击 “ 印 载 ?。 然 后， 按 第 1 章 的 说 明 再 次 执 
行 安 疤 程序 ， 并 确保 选择 了 复 选 框 Add Python to 
PATH 以 及 其 他 与 系统 相关 的 设置 。 如 果 还 是 无 法 运 
行 Python， 又 不 知道 到 哪里 去 寻求 帮助 ， 请 参阅 附录 
C 的 建议 。 


A.2 macOS 系 统 


第 1 章 的 安装 说 明 让 你 使 用 Python 网 站 提供 的 安装 程 
序 ， 我 推荐 你 这 样 做 ， 除 非 有 特殊 原因 。 另 一 种 方法 
是 使 用 Homebrew， 在 macOS 系 统 中 ， 可 使 用 这 个 工 
具 来 安装 各 种 软件 。 如 果 你 使 用 过 Homebrew 并 想 使 
用 它 来 安装 Python， 或 者 有 同事 在 使 用 Homebrew 而 
你 也 想 安 装 它 ， 请 参阅 接 下 来 的 说 明 。 


A.2.1 安装 Homebrew 


Homebrew 依 赖 于 Apple Xcode 包 中 的 一 些 命令 行 工 
具 ， 因 此 你 需要 先 安装 Xcode 命令 行 工 具 。 为 此 ， 打 
开 一 个 终 问 窗口 并 执行 如 下 命令 : 


$ xcode-select --install 


在 不 断 出 现 的 确认 对 话 杠 中 都 单 击 OK 按 钮 。 《根据 
网 络 连接 的 速度 ， 这 可 能 持续 一 段 时 间 。) 接 下 来 执 
行 如 下 命令 以 安装 Homebrew: 


$ /usr/bin/ruby -e "$(curl -fsSL 
https://raw.githubusercontent.com/Homebrew/install/mastae 


这 个 命令 可 在 Homebrew 网 站 找到 。 务 必 在 curl - 
fsSL 和 URL 之 间 包 含 一 个 空格 。 


注意 ”这 个 命令 中 的 -e 让 Ruby 〈Homebrew 驶 
是 使 用 这 种 编程 语言 编写 的 ) 执行 下 载 的 代码 。 
除非 来 源 是 你 信任 的 ， 人 否则 不 要 运行 这 样 的 命 
人 


为 确认 正确 地 安装 了 Homebrew， 请 执行 如 下 命令 : 


$ brew doctor 
Your system is ready to brew. 


上 述 输 出 表明 ， 可 以 使 用 Homebrew 在 系统 中 安装 包 
下 


A.2.2 ”安装 Python 
为 安装 最 新 的 Python 版 本 ， 请 执行 如 下 命令 : 


$ brew install python 


使 用 下 面 的 命令 检查 安 六 的 是 哪个 版 本 : 


$ python3 --version 
Python 3.7.2 


$ 


现在 ， 可 以 使 用 命令 python3 来 启动 Python 终端 会 话 
了 ， 还 可 以 使 用 命令 python3 来 配置 文本 编辑 器 ， 使 
其 使 用 刚 安装 的 Python 版 本 《而 不 是 系统 目 带 的 版 
本 ) 来 运行 Python 程序 。 如 果 不 知道 如 何 配置 Sublime 
人 刚 安 装 的 Python 版 本 ， 请 参阅 第 1 章 的 说 

明 。 


A.3 Linux 系 统 


几乎 所 有 Linux 系 统 都 默认 安装 了 Python， 但 如 果 自 
带 的 版 本 低 于 Python 3.6， 就 需要 安装 最 新 的 版 本 。 
下 面 的 说 明 适 用 于 大 多 数 基 于 apt 的 系统 。 


你 将 使 用 名 为 deadsnakes 的 包 ， 它 能 让 你 轻松 地 安 
装 多 个 Python 版 本 。 请 执行 如 下 命令 : 


$ sudo add-apt-repository ppa:deadsnakes/ppa 
$ sudo apt-get Update 


$ sudo apt install python3.7 


这 些 命令 将 在 你 的 系统 中 安装 Python 3.7。 


执行 下 面 的 命令 启动 一 个 运行 Python 3.7 的 终端 会 
话 : 


$ python3.7 
>>> 


配置 文本 编辑 器 使 其 3.7 以 及 从 终端 运行 
程序 时 ， 也 需要 用 到 这 个 命令 


A.4 Python 关键 字 和 内 置 函 数 


Python 包含 一 系列 关键 字 和 内 置 函数 ， 给 变量 命名 
时 ， 知 道 这 些 关 键 字 和 内 置 函数 很 重要 : 不 能 将 
Python 关 键 字 用 作 变 量 名 ， 也 不 应 将 Python 内 置 函数 
的 名 称 用 作 变 量 名 ， 人 否则 将 履 盖 相应 的 内 置 函数 。 


本 节 将 列 出 Python 关键 字 和 内 置 函 数 的 名 称 ， 让 你 知 
道 应 避免 使 用 哪些 变量 名 。 


A.4.1 Python 关键 字 


下 面 的 关键 字 都 有 特殊 含义 ， 如 果 将 它们 用 作 变 量 
名 ， 将 引发 错误 : 


False await else ijmport pass 
None break except in raise 
True class finally is return 
and continue for lambda try 


as def from nonlocal while 
assert del global not with 
async elif if or yield 


A.4.2 ”Python 内 置 函 数 


将 内 置 函数 名 用 作 变 量 名 时 ， 不 会 导致 错误 ， 但 将 履 
盖 这 些 函 数 的 行为 : 


abs() delattr() hash() memoryview 
all() dict() help() min() 
any() dir() hex() next() 
ascii() divmod() id() object() 
bin() enumerate() input() oct() 


bool() eval() int() open() 
breakpoint() exec() isinstance() ord() 
bytearray() filter() issubclass() pow() 
bytes() float() iter() print() 


callable() 
chr() 
classmethod() 
compile() 
complex() 


format() 
frozenset() 
getattr() 
globals() 
hasattr() 


len() 
list() 
locals() 


map() 
max() 


property() 
range() 
repr() 
reversed() 
round() 


附录 B 文本 编辑 厚 与 
IDE 


程序 员 要 花费 大 量 时 间 编 写 、 阅 读 和 
编辑 代码 ， 因此 必须 使 用 文本 编辑 器 或 集成 开发 
环境 (IDE) 来 尽 可 能 提高 效率 。 好 的 编辑 器 会 
做 些 简单 的 工作 ， 如 突出 代码 结构 ， 帮 助 你 在 编 
时 期间 发 现 和 常见 的 bug， 但 是 叉 不 会 做 得 太 多 ， 
以 免 打 断 你 的 思路 。 编 辑 器 还 提供 了 一 些 很 有 用 
的 功能 ， 如 上 自动 缩 进 、 标 识 出 合适 的 行 长 以 及 提 
供 常 用 操作 的 快捷 键 。 


IDE 是 一 种 提供 了 大 量 其 他 工具 (如 交互 式 调试 器 和 
代码 检视 器 ) 的 文本 编辑 器 。IDE 在 你 输入 代码 时 对 
其 进行 检查 ， 力 图 弄 清 你 创建 的 项 目 是 什么 样 的 。 例 
如 ， 当 你 输入 函数 名 时 ，IDE 可 能 显示 该 函数 接受 的 
所 有 参数 。 在 一 切 顺利 且 你 明白 显示 的 内 容 时 ， 这 可 
能 很 有 帮助 。 不 过 对 初学 者 来 说 ， 这 可 能 是 极 大 的 负 
和 因为 他 们 可 能 不 明白 为 何在 IDE 中 输入 的 代码 不 
可 行 。 


我 建议 你 在 学 习 编 程 期 间 使 用 简单 的 文本 编辑 器 。 文 
本 编辑 器 给 系统 带 来 的 负担 轻 得 多 ， 因 此 如 果 你 使 用 
的 计算 机 较 旧 或 配置 的 资源 有 限 ， 文 本 编辑 器 运行 起 
来 将 比 IDE 顺 畅 得 多 。 如 果 你 熟悉 IDE 或 者 周围 有 人 
在 使 用 IDE 而 你 也 想 在 这 样 的 环境 中 编程 ， 则 完全 可 
以 尝试 使 用 IDE。 


就 目前 而 言 ， 不 用 太 操 心 工具 选择 的 问题 ， 还 不 如 将 
| 了 解 Python 语 言 和 开发 感 兴趣 的 项 目 

上 上。 掌握 基础 知识 后 ， 就 会 更 清楚 什么 样 的 工具 适合 
你 。 


本 附录 介绍 如 何 配置 文 本 编辑 器 Sublime Text， 以 提 
高 工作 效率 。 最 后 还 将 简单 介绍 众多 其 他 编辑 器 ， 你 


i 
它们 。 


B.1 有 自 定义 Sublime Text 设 置 


在 第 1 章 ， 你 配置 了 Sublime Text， 使 其 使 用 所 需 的 
Python 版 本 来 运行 程序 。 下 面 来 配置 其 他 方面 ， 让 
Sublime Text 完 成 本 附录 开头 提 到 的 一 些 工 作 。 


B.1.1 将 制 表 符 转 换 为 空格 


如 果 在 代码 中 混用 制 表 符 和 空格 键 ， 可 能 导致 程序 出 
现 难 以 调试 的 问题 。 为 避免 这 种 情况 发 生 ， 可 配置 
Sublime Text， 使 其 总 是 使 用 空格 来 缩 进 ， 即 便 你 按 
下 Tab 键 亦 如 此 。 为 此 ， 打 开 荣 单 View 
Indentation， 核 实 选 择 了 Indent Using Spaces。 如 果 没 
有 ， 现 在 选择 就 它 ， 并 确保 将 Tab Width 设 置 为 4 个 空 
格 。 


如 果 你 已 经 在 程序 中 混用 了 制 表 符 和 空格 ， 可 将 所 有 
制 表 符 都 转换 为 空格 ， 方 法 是 选择 沫 单 View * 
Indentation > Convert Tabs to Spaces。 也 可 通过 单 击 
Sublime Text 窗 口 右 下 角 的 Spaces 字 样 来 访问 这 些 设 
置 。 


现在 如 果 按 Tab 键 来 缩 进 代码 行 ，Sublime Text 将 自动 
将 制 表 符 转 换 为 指定 数量 的 空格 。 


B.1.2 ”设置 行 长 标志 


大 多 数 编辑 器 允许 你 设置 视觉 线索 (通常 是 竖 线 ) ， 
指出 代码 行 应 在 哪里 结束 。 在 Python 社 区 ， 这 方面 的 
约定 是 行 长 不 要 超过 79 字 符 。 要 设置 这 种 标志 ， 可 打 
开 菜 单 View w Ruler， 再 选择 80。Sublime Text 将 在 第 
80 字 符 标 志 处 放置 一 条 竖 线 ， 帮 助 确保 代码 行 的 长 度 


是 合适 的 。 


B.1.3 缩 进 和 取消 缩 进 代码 块 


要 缩 进 代 码 块 ， 可 选择 它 ， 再 选择 菜单 Edit w Line > 
Indent 或 按 Ctrl + ] (macOS 系 统 中 为 Command + ]) 。 
要 取消 缩 进 代码 块 ， 可 选择 菜单 Edit w Line ?> 
Unindent 或 按 Ctrl + [ CmacOS 系 统 中 为 Command + 
[we 


B.1.4 ”将 代码 块 注释 掉 


要 暂时 禁用 代码 块 ， 可 选中 它 并 注释 控 ， 从 而 让 
Python 忽略 它 。 通 过 选择 沫 单 Edit w Comment * 
Toggle Comment 或 按 Ctrl +/ (macOS 系 统 中 为 
Command+ /) ， 可 将 选 定 的 代码 行 注 释 掉 : 在 行 首 
添加 井 号 〈#) ， 并 保持 缩 进程 上 度 不 变 ， 以 指出 这 不 
是 常规 注释 。 要 对 代码 块 取消 注释 ， 可 选中 它 ， 并 再 
次 选择 前 述 染 单项 。 


B.1.5 ”保存 配置 


前 面 提 到 的 一 些 设置 只 影响 当前 文件 ， 要 让 设置 影 啊 
所 有 在 Sublime Text 中 打开 的 文件 ， 需 要 定义 用 户 设 
置 。 为 此 选择 菜单 Preferences > Settings， 找 到 文件 
Preferences.sublime-settings -~ User， 并 在 其 中 输入 如 
下 内 容 : 


{ 
"rulers": [86]， 
"translate tabs to spaces": true 


} 


保存 这 个 文件 ， 则 指定 的 标尺 和 制 表 符 设置 将 被 应 用 
于 在 Sublime Text 中 打开 的 所 有 文件 。 在 这 个 文件 中 
添加 设置 时 ， 确 保 每 行 都 以 逗号 结尾 ， 但 最 后 一 行 例 
外 。 你 可 以 在 网 上 和 碍 看 其 他 用 户 的 设置 文件 ， 进 而 目 
定义 编辑 器 ， 以 最 大 限度 地 提高 工作 效率 。 


B.1.6 ”进一步 自 定义 


你 有 


尔 能 以 众多 方式 自 定义 Sublime Text， 进 一 步 提高 工 
作 效 紊 。 探 索 有 菜单 时 ， 要 留意 最 常用 的 菜 单项 的 键盘 
快捷 键 。 通 过 使 用 键盘 快捷 键 而 不 是 鼠标 或 触摸 板 来 
执行 操作 ， 可 提高 效率 。 不 要 试图 一 次 性 记 住 所 有 的 
快捷 键 ， 只 需 记 住 最 常 执行 的 操作 的 快捷 键 就 行 ， 同 
时 看 看 有 没有 其 他 功能 可 帮助 你 改善 工作 流程 。 


B.2 ”其 他 文本 编辑 器 和 IDE 


你 肯定 会 听 说 众多 其 他 的 文本 编辑 器 ， 或 者 看 到 有 人 
使 用 这 些 编辑 器 。 对 于 这 些 编辑 器 ， 通 常 可 像 自 定义 
Sublime Text 那 样 进 行 配 置 。 下 面 介 绍 你 可 能 听 人 说 
到 的 一 些 文 本 编辑 器 。 


B.2.1 IDLE 


IDLE 是 Python 自 融 的 文本 编辑 器 。 相 比 于 Sublime 
Text， 它 不 那么 直观 ， 但 有 些 初 学 者 教程 可 能 会 提 到 
它 ， 因 此 你 可 能 想 试 一 试 。 


B.2.2 Geany 


Geany 是 一 于 简单 的 编辑 器 ， 你 可 在 其 中 直接 运行 所 
有 的 程序 。 它 在 终端 窗口 中 显示 所 有 输出 ， 有 助 于 你 
逐渐 习惯 使 用 终端 。Geany 的 界面 非常 简单 ， 但 功能 
强大 ， 因 此 很 多 经 验 丰 富 的 程序 员 也 在 使 用 它 。 


B.2.3 Emacs 和 Vim 


Emacs 和 Vim 是 两 于 流行 的 编辑 器 ， 深 受众 多 经 验 丰 
富 的 程序 员 乾 爱 ， 因 为 使 用 它们 时 ， 用 户 的 手 根本 不 
用 离开 键盘 。 因 此 学 会 使 用 这 些 编辑 器 后 ， 编 写 、 疯 
读 和 编辑 代码 的 效率 将 获得 极 大 提高 。 不 过 这 也 意味 
着 学 会 使 用 它们 的 难度 极 大 。 大 多 数 Linux 和 macOS 

计算 机 自 带 Vim， 而 且 Emacs 和 Vim 都 可 完全 在 终端 

中 运行 ， 因 此 它们 常 被 用 来 通过 远程 终端 会 话 在 服务 
器 上 编写 代码 。 


程序 员 通 常会 推荐 你 试 一 斌 它们， 但 很 多 编程 老手 未 
了 编程 新 手 要 学 习 的 东西 实在 太 多 了 。 知 道 这 些 编辑 
需 是 有 益 的 ， 但 请 先 使 用 简单 编辑 器 ， 以 便 专 注 于 学 
习 编 程 ， 而 不 是 费时 间 去 学 习 如 何 使 用 编辑 器 。 等 你 
能 够 熟悉 地 编写 和 编辑 代码 后 ， 再 去 使 用 这 些 编辑 骨 


吧 :。 
B.2.4 Atom 


Atom 是 一 球 文 本 编辑 器 ， 但 提供 了 一 些 通常 只 有 IDE 
才 提 供 的 功能 。 在 Atom 中 ， 可 以 打开 单个 文件 ， 也 
可 打开 项 目 文 件 夹 并 轻松 地 访问 项 目 中 所 有 的 文件 。 
Atom 和 集成 了 Git 和 GitHub， 在 需要 使 用 版 本 控制 时 ， 

这 让 你 在 编辑 器 中 就 能 使 用 本 地 仓库 和 远程 仓库 ， 无 
须 切 换 到 另 一 个 终端 窗口 。 


Atom 还 允许 你 安装 包 ， 从 而 以 众多 方式 扩展 其 功 
能 。 可 安装 的 包 有 很 多 ， 这 让 Atom 更 像 一 个 IDE。 


B.2.5 Visual Studio Code 


Visual Studio Code (VS Code) 也 是 一 款 类 似 于 IDE 的 
编辑 器 ， 让 你 能 够 高 效 地 使 用 调试 器 ， 还 集成 了 版 本 
控制 功能 并 提供 了 代码 补 全 工具 。 


B.2.6 PyCharm 


PyCharm 是 一 款 深 受 Python 程序 员 欢 迎 的 IDE， 因 为 

它 是 专门 为 使 用 Python 编程 而 开发 的 。 完 整 版 需要 付 

费 订 阅 ， 但 很 多 开发 人 员 沉 得 免费 的 社区 版 
(PyCharm Community Edition ) 也 很 有 用 。 


PyCharm 提 供 了 一 个 linter ， 它 检查 编码 是 否 遵循 了 
普遍 接受 的 Python 编程 约定 ， 并 在 代码 不 符合 Python 
代码 格式 设置 时 提出 修改 建议 。 它 集成 了 调试 右 ， 肯 
在 帮助 你 高 效 消除 错误 ， 还 支持 各 种 模式 ， 让 你 能 够 
高 效 地 使 用 众多 流行 的 Python 库 。 


B.2.7 Jupyter Notebook 


Jupyter Notebook 不 属于 传统 的 文本 编辑 右 或 IDE， 而 
是 一 款 主要 由 块 组 成 的 Web 应 用 程序 。 每 个 块 都 要 么 


是 代码 块 ， 要 么 是 文本 块 ， 其 中 的 文本 块 采用 
Markdown 格 式 ， 让 你 能 够 设置 简单 的 文本 格式 。 


最 初 开发 时 ，Jupyter Notebook 旨 在 支持 在 科学 应 用 程 
序 中 使 用 Python， 但 经 过 不 断 的 扩展 后 ， 它 在 很 多 情 
形 下 都 很 有 用 。 在 Jupyter Notebook 中 ， 不 仅 可 在 .py 

文件 中 添加 注释 ， 还 可 编写 带 简 单 格 式 的 文本 ， 如 标 
题 、 带 项 目 符号 的 列表 和 在 不 同 代码 片段 之 间 导 航 的 
超 链接 。 每 个 代码 块 都 可 独立 运行 ， 让 你 能 够 测试 程 
序 的 一 小 部 分 或 同时 运行 所 有 的 代码 块 。 每 个 代码 块 
都 有 独立 的 输出 区 域 ， 可 根据 需要 显示 或 隐藏 。 


Jupyter Notebook 不 同 单元 格 〈cell) 之 间 的 交互 有 时 
可 能 会 令 你 迷惑 。 例 如 ， 如 果 在 一 个 单元 格 中 定义 了 
一 个 函数 ， 在 其 他 单元 格 中 也 可 使 用 。 这 在 大 多 数 情 
况 下 是 有 益 的 ， 但 如 果 Notebook 很 长 ， 而 你 又 对 

NE 就 会 感到 


如 末 你 使 用 Python 进行 科学 编程 或 以 数据 为 核心 的 编 
程 ， 肯 定 会 过 到 Jupyter Notebook。 


附录 C 寻求 帮助 


SS 每 个 人 学 习 编 程 时 都 会 遇 到 困难 ， 
此 作为 程序 员 ， 需 要 学 习 的 最 重要 的 撤 能 之 一 就 
征 如 何 高 效 地 摆脱 困境 。 本 附录 简要 介绍 几 种 帮 
助 你 摆脱 编程 困境 的 方法 。 


C.1 第 一 步 
陷入 困境 后 ， 首 移 需 要 判断 形势 。 回 别人 寻求 帮助 


前 ， 请 回答 如 下 三 个 问题 。 


。 你 想 要 做 什么 ? 
。 你 已 尝试 哪些 方式 ? 
。 结果 如 何 ? 


答案 应 尽 可 能 具体 。 对 于 第 一 个 问题 ， 像 “我 要 在 
Windows 10 笔 记 本 计算 机 上 安装 最 新 版 Python” 这 样 
明确 的 陈述 足够 详细 ， 让 Python 社区 的 其 他 人 员 能 够 
施 以 援手 ， 而 像 “ 我 要 安装 Python” 这 样 的 陈述 则 没有 
提供 足够 的 信息 ， 让 别人 无 法 提供 太 多 帮助 。 


对 于 第 二 个 问题 ， 管 案 应 提供 足够 多 的 细节 ， 这 样 别 
人 束 不 会 建议 你 去 重复 尝试 过 的 方式 : 相 比 于 “我 访 
问 Python 网 站 ， 并 下 载 了 一 些 东 西 >，“ 我 访问 Python 
官方 网 站 的 下 载 页 面 ， 单 击 针 对 我 所 使 用 系统 的 
Downloadie 再 运行 安装 程序 ”提供 的 信息 更 详 
细 。 


对 于 第 三 个 问题 ， 知 道 准确 的 错误 消息 很 有 用 ， 因 为 
这 样 可 在 线 搜索 错误 消息 以 寻找 解决 方案 ， 也 可 在 问 
别人 寻求 帮助 时 提供 错误 消息 。 


有 了 时候， 只 需要 回答 这 三 个 问题 ， 你 就 能 发 现 遗 漏 了 
什么 ， 无 须 求助 就 能 摆脱 困境 。 程 序 员 甚 至 给 这 种 情 
形 取 了 一 个 名 字 : 橡皮 鸭子 调试 法 。 如 果 同 一 只 橡 
皮 胸 子 (或 任何 无 生命 的 东西 清楚 地 阐述 自己 的 处 
境 ， 并 提出 具体 的 问题 ， 常 常 能 够 回答 这 个 问题 。 有 
些 编程 公司 甚至 会 在 办 公 室 放 置 一 个 橡皮 鸭子 ， 骨 在 
或 励 程序 员 “ 与 这 只 鸭子 交流 ”。 


C.1.1 再 试 试 


只 再 回 过 头 去 重新 来 一 次 ， 就 足以 解决 很 多 问题 。 假 
设 你 在 模仿 本 书 的 一 个 示例 编写 for 循环 时 ， 可 能 遗 
漏 了 某 种 简单 的 东西 ， 如 for 语句 末尾 的 冒号 。 再 试 
一 次 可 能 就 会 帮助 你 避免 重复 同样 的 错误 。 


C.1.2 欣 一 会 儿 


如 果 你 很 长 时 间 内 一 直 在 试图 解决 同一 个 问题 ， 那 么 
休 妃 一 会 儿 实 际 上 是 你 可 采取 的 最 佳 战术 。 长 时 间 从 
事 一 个 任务 时 ， 你 可 能 变 得 一 根 筋 ， 脑 子 里 想 的 都 是 
一 个 解决 方案 。 你 往往 会 对 所 做 的 假设 视而不见 ， 而 
休 已 一 会 儿 有 助 于 你 从 不 同 的 角度 看 问题 。 不 用 休 妨 
很 长 时 间 ， 只 要 能 够 摆脱 当前 的 思维 方式 就 行 。 如 果 
你 坐 了 很 长 时 间 ， 束 起 来 做 做 运动 : 散 散 步 或 者 去 室 
外 每 一 会 儿 ， 也 可 以 哆 杯 水 ， 或 者 吃 点 清淡 而 健康 的 


零食 


如 末 你 心情 诅 背 ， 也 许 该 将 工作 放 到 一 边 ， 整 天 都 不 
再 考虑 。 晚 上 睡 个 好 党 后 ， 你 帝 利 会 用 现 问题 并 不 是 
那么 难以 解决 。 


C.1.3 ”参考 本 书 的 在 线 资 源 


本 书 提供 了 配套 的 在 线 资 源 ， 网 址 为 
ituring.cn/book/2784， 其 中 包含 大 量 有 用 的 信息 ， 比 
如 如 何 设置 系统 以 及 如 何 解决 每 章 可 能 过 到 的 难题 。 
如 有 果 你 还 没有 查看 这 些 资源 ， 现 在 就 去 吧 ， 看 看 它们 
能 否 提 供 帮 助 。 


C.2 在 线 搜索 


很 可 能 有 人 遇 到 过 你 面临 的 问题 ， 并 在 网 上 发 表 了 相 
关 的 文章 。 民 好 的 搜索 技能 和 有 具体 的 关键 词 有 助 于 找 
到 现 有 的 资源 ， 帮 助 解 决 你 面临 的 问题 。 例 如 ， 如 果 
无 法 在 Windows 10 系 统 中 安装 最 新 版 Python， 搜 

索 “Windows 10 安装 Python) 并 将 结果 限定 为 一 年 
内 ， 可 能 让 你 找到 清晰 的 解决 方案 。 


使 用 计算 机 显示 的 错误 消息 进行 搜索 也 很 有 帮助 。 例 
如 ， 假 设 你 试图 启动 Python 终端 会 话 时 出 现 了 如 下 错 
误 消 息 : 


> python 
“python” is not recognized as an internal or external cod 
operable program or batch file 


> 


通过 搜索 完整 的 错误 消息 python is not recognized as 
an internal or external command”， 也 许 能 得 到 不 错 的 
建议 。 

搜索 与 编程 相关 的 主题 时 ， 有 几 个 网 站 会 反复 出 现 。 
下 面 简要 地 介绍 一 下 这 些 网 站 ， 让 你 知道 它们 可 能 提 
供 什么 样 的 帮助 。 


C.2.1 Stack Overflow 


Stack Overflow 是 最 受 程序 员 欢 迎 的 问答 网 站 之 一 ， 
当 你 执行 与 Python 相关 的 搜索 时 ， 它 常常 会 出 现在 第 
一 个 结果 页 中 。Stack Overflow 的 成 员 在 陷入 困境 时 
提出 问题 ， 其 他 成 员 会 努力 提供 有 帮助 的 答案 。 用 户 
可 推荐 其 认为 最 有 帮助 的 答案 ， 因 此 前 几 个 答案 通常 
就 是 最 佳 答 案 。 


对 于 很 多 基本 的 Python 问题 ， 在 Stack Overflow 上 有 非 
第 明确 的 答 守 ， 因 为 这 个 社区 在 不 断 改进 。 它 喜 励 用 
户 发 布 更 新 的 帖子 ， 因 此 这 里 的 答案 通常 与 时 俱 进 。 
本 书 编写 期 间 ，Stack Overflow 回 答 的 与 Python 相 关 的 
问题 超过 了 一 百 万 个 。 


C.2.2 Python 官方 文档 


对 初学 者 来 说 ，Python 官 方 文档 显得 有 点 漫不经心 ， 
因为 其 主要 目的 是 阐述 这 门 语言 ， 而 不 是 进行 解释 。 
官方 文档 中 的 示例 应 该 很 有 8 用， 但 你 也 许 不 能 完全 弄 
展 。 虽 然 如 此 ， 这 还 是 一 个 不 错 的 资源 ， 如 果 它 出 现 
在 搜索 结果 中 ， 束 值得 你 去 参考 ， 为 外 ， 随 着 你 对 
0 


C.2.3 ”官方 库 文 档 


如 果 你 使 用 了 库 ， 如 Pygame、Matplotlib 和 Django 
和 等， 搜索 结果 中 通常 会 包含 到 其 官方 文档 的 链接 。 例 
如 ，Django 文 档 就 很 有 用 。 如 果 你 要 使 用 这 些 库 ， 最 
好 熟悉 其 官方 文档 。 


C.2.4 learnpython 


Reddit 包 含 很 多 子 论 坛 ， 这 些 子 论坛 称 为 subreddit ， 
其 中 的 wlearnpython 非 常 活跃， 提供 的 信息 也 很 有 帮 
助 。 你 可 以 在 这 里 阅读 其 他 人 提出 的 问题 ， 也 可 以 提 
出 自己 的 问题 。 


C.2.5 ”博客 


很 多 程序 员 有 博客 ， 旨 在 与 他 人 分 享 对 目 己 所 使 用 语 
言 的 心得 。 接 受 博 客 文章 提供 的 建议 前 ， 应 大 致 浏览 
一 下 前 几 条 评论 ， 看 看 别人 的 反 饿 。 如 有 果 文 章 没 有 任 
何 评论 ， 请 对 其 持 保 留 态度 一 一 可 能 还 没有 人 验证 过 
其 中 的 建议 。 


C3 IRC 


很 多 程序 员 通 过 IRC (Internet Relay Chat， 互 联网 中 
继 聊 天 〉 实 时 交流 。 如 果 你 被 问题 困 住 ， 在 网 上 搜索 
也 找 不 到 管 案 ， 那 么 在 相关 的 IRC 频 道 (channel) 中 
寻求 帮助 可 能 是 最 佳 选择 。 这 些 频道 里 的 人 大 多 彬 档 
有 有礼、 乐于 助人 ， 在 你 能 够 详细 地 描述 要 做 什么 、 父 
试 了 哪些 方法 及 其 结果 时 尤其 如 此 。 


Python 主 频道 是 #python 。 频 道 挫 learnpython (两 个 
井 号 ) 也 非常 活跃 。 这 个 频道 与 learnpython/ 相 关 
联 ， 因 此 你 在 其 中 也 将 看 到 有 关 wlearnpython 上 帖子 
的 消息 。 如 果 你 正在 开发 Web 应 用 程序 ， 可 能 想 加 入 
频道 #django。 加 入 频道 后 ， 就 可 以 看 到 其 他 人 的 交 
流 ， 还 可 以 提出 问题 。 


要 获得 有 效 的 帮助 ， 你 需要 知道 一 些 有 关 IRC 文 化 的 
细节 。 将 重点 放 在 本 附录 开头 所 说 的 三 个 问题 上 ， 无 
疑 有 助 于 获得 可 行 的 解决 方案 。 如 果 能 准确 地 阐述 你 
要 做 人 什么、 尝试 了 哪些 方法 以 及 得 到 的 结果 ， 别 人 就 
会 乐意 伸 出 援手 。 为 分 享 代码 或 输出 ，IRC 成 员 会 使 
用 外 部 网 站 ， 如 bPaste (#python 通 过 它 来 分 享 代码 和 
输出 ) 。 这 能 避免 让 频道 到 处 都 是 代码 ， 还 让 分 享 的 
代码 阅读 起 来 容易 得 多 。 一 定 要 有 附 心 ， 这 样 别人 才 
会 更 乐意 帮助 你 。 准 确 地 提出 问题 ， 并 等 竺 别人 来 回 
答 。 虽 然 大 家 都 在 忙于 交流 ， 但 总 会 有 人 及 时 回答 你 
的 问题 。 如 果 频 道 的 参与 者 较 少 ， 可 能 要 过 一 段 时 间 
才 会 有 人 回答 你 的 问题 。 


C.4 Slack 


Slack 有 点 像 现代 版 IRC， 通 常用 于 公司 内 部 交流 ， 但 
也 有 很 多 面 问 公众 的 讨论 组 。 要 碍 看 Slack Python 讨 
论 组 ， 可 访问 PySlackers 网 站 ， 单 击 页 面 顶部 的 链接 
Slack， 再 输入 电子 邮箱 地 址 以 获取 邀请 图。 进入 
Python Developers 区 后 ， 将 看 到 一 个 频道 列表 ， 你 可 
单 击 Channels 并 选择 感 兴趣 的 主题 。 首 先 应 加 入 的 可 
能 是 频道 机 earning_python 和 和 #django。 


C.5 Discord 


Discord 也 是 一 个 在 线 聊 天 环境 。 它 包含 一 个 Python 社 
区 ， 你 可 以 在 其 中 寻求 帮助 ， 还 可 以 参加 与 Python 相 
关 的 讨论 。 要 进入 该 社区 ， 可 访问 Python Discord 网 
站 ， 再 单 击 页 面 右上 角 的 DISCORD logo。 在 出 现 的 
屏幕 中 ， 有 一 个 自动 生成 的 邀请 函 。 如 果 有 Discord 账 
户 ， 可 使 用 它 登录 ; 如 果 没 有 ， 请 输入 用 户 名 并 按 提 
示 完 成 Discord 注 册 过 程 。 首 次 访问 Python Discord 

时 ， 需 要 接受 社区 行为 准则 才能 参与 其 中 。 完 成 注册 
并 登录 后 ， 就 能 加 入 任何 感 兴趣 的 频道 了 。 寻 求 帮 助 
时 ， 务 必 在 Python Help 频 道 发 帖 。 


附录 D 使 用 Git 进 行 版 本 
控制 


Ke 版 本 控制 软件 让 你 能 够 拍摄 处 于 可 行 
状态 的 项 目 快照 。 修 改 项 目 〈 如 实现 新 功能 ) 
行 状态 。 


通过 使 用 版 本 控制 软件 ， 你 可 以 放手 去 改进 项 目 ， 不 
用 担心 项 目 因 你 犯错 而 遭 到 破坏 。 对 大 型 项 目 来 说 ， 
这 显得 尤其 重要 ， 但 对 于 较 小 的 项 目 ， 哪 人 是 只 包含 
一 个 文件 的 程序 ， 这 也 大 有 神 益 。 


在 本 附录 中 ， 你 将 学 习 如 何 安 逆 Git， 以 及 如 何 使 用 
它 来 对 当前 开发 的 程序 进行 版 本 控制 。Git 是 当前 最 
流行 的 版 本 控制 软件 ， 包 含 很 多 高 级 工具 ， 可 帮助 团 
队 协 作 开 发 大 型 项 目 ， 但 其 最 基本 的 功能 也 非常 适合 
独立 开发 人 员 使 用 。Git 通 过 跟踪 对 项 目 中 每 个 文件 
的 修改 来 实现 版 本 控制 ， 如 果 你 犯 了 错 ， 只 需 恢 复 到 
保存 的 前 一 个 状态 即 可 。 


D.1 安装 Git 


Git 可 在 所 有 操作 系统 上 运行 ， 但 安装 方法 随 操作 系 
统 而 异 。 接 下 来 的 几 小 市 详细 说 明了 如 何在 各 种 操作 
系统 中 安装 它 。 


D.1.1 Windows 系 统 


可 从 Git 网 站 下 载 Git 安 六 程序 。 在 这 个 网 站 中 ， 你 将 
看 到 下 载 链接 ， 指 同 适 合 你 的 系统 的 安装 程序 。 


D.1.2 macOS 系 统 


macOS 系 统 可 能 已 经 安装 了 Git， 因 此 请 尝试 执行 命 
令 git --version 。 如 果 在 输出 中 看 到 了 具体 的 版 
本 号 ， 说 明 系 统 安装 了 Git， 如 果 看 到 一 条 消息 ， 提 
示 你 安装 或 升级 Git， 只 需 按 屏幕 上 的 说 明 做 即 可 。 


你 也 可 以 访问 Git 网 站 主页 ， 将 看 到 下 载 链接 ， 指 向 
适合 你 系统 的 安装 程序 。 


D.1.3 Linux 系 统 


要 在 Linux 系 统 中 安装 Git， 请 执行 如 下 命令 : 


$ sudo apt instal1 git-all 


这 就 行 了 。 现 在 可 以 在 项 目 中 使 用 Git 了 。 


D.1.4 ”配置 Git 


Git 跟 踪 是 谁 修改 了 项 目 ， 哪 怕 参 与 项 目 开 发 的 人 只 
有 一 个 。 为 此 ，Git 需 要 知道 你 的 用 户 名 和 电子 邮箱 
地 址 。 你 必须 提供 用 户 名 ， 但 可 使 用 虚构 的 电子 邮箱 


地 址 : 


$ git config --global user.name " username _" 
$ git config --global user.email "_username@example.com 


如 果 你 扎 记 了 这 一 步 ， 在 首次 提交 时 Git 将 提示 你 提 
供 这 些 信息 。 


D.2 创建 项 目 

我 们 来 创建 一 个 要 进行 版 本 控制 的 项 目 。 在 系统 中 创 
吾 一 个 文件 来， 并 将 其 命名 为 git_practice。 在 这 个 文 
件 夹 中 ， 创 建 一 个 简单 的 Python 程序 ; 


hello_git.py 


print("Hello Git world!") 


我 们 将 使 用 这 个 程序 来 探索 Git 的 基本 功能 。 


D.3 忽略 文件 


扩展 名 为 .pyc 的 文件 是 根据 .py 文件 自动 生成 的 ， 因 此 
无 须 让 Git 跟 踊 它 们 。 这 些 文件 存储 在 目录 
_pycache 中。 为 了 让 Git 忽 略 这 个 目录 ， 创 建 一 个 
名 为 .gitignore 的 特殊 文件 〈 这 个 文件 名 以 句点 打头 且 
没有 扩展 名 ) ， 并 在 其 中 添加 下 面 一 行内 容 : 


.gitignore 


pycache_/ 


这 让 Git 忽 略 目 录 pycache_ 中 的 所 有 文件 。 使 用 文 
件 .gitignore 可 避免 项 目 混 乱 ， 让 其 开发 起 来 更 容易 。 


你 可 能 需要 修改 文本 编辑 器 的 设置 ， 使 其 显示 隐藏 的 
文件 ， 这 样 才能 使 用 它 来 打开 文件 .gitignore。 有 些 编 
辑 器 被 设置 成 忽略 名 称 以 句点 打头 的 文件 。 


D.4 初始 化 仓库 


前 面 创建 了 一 个 目录 ， 其 中 包含 一 个 Python 文件 和 一 
个 .gitignore 文 件 ， 现 在 可 以 初始 化 一 个 Git 仓 库 了 。 为 
此 ， 打 开 一 个 终端 窗口 ， 切 换 到 文件 夹 git_practice， 
并 执行 如 下 命令 : 


git practice$ git init 
Initialized empty Git repository in git practice/.git/ 


git practices$ 


输出 表明 Git 在 git_practice 中 初始 化 了 一 个 空仓 库 。 仓 
库 是 程序 中 被 Git 主 动 跟踪 的 一 组 文件 。Git 用 来 管理 
仓库 的 文件 都 存储 在 隐藏 的 目录 .git 中 ， 你 根本 不 需 
要 与 这 个 目录 打交道 ， 但 千 万 不 要 删除 它 ， 人 否则 将 丢 
失 项 目的 所 有 历史 记录 。 


D.5 检查 状态 
执行 其 他 操作 前 ， 先 来 看 一 下 项 目的 状态 : 


git practice$ git status 
@ On branch master 


No commits yet 


@ Untracked files: 
(use "git add <file>..." to include in what will be 


.gitignore 
hello git.py 


©® nothing added to commit but untracked files present ( 
git practices$ 


在 Git 中 ， 分 文 是 项 目的 一 个 版 本 。 从 这 里 的 输出 可 
知 ， 我 们 位 于 分 支 master 上 ( 见 @) 。 你 每 次 查看 
项 目的 状态 时 ， 输 出 都 将 指出 位 于 分 支 master 上 。 
接 下 来 的 输出 表明 还 未 执行 任何 提交 。 提 交 是 项 目 
在 特定 时 点 的 快照 。 


Git 指 出 了 项 目 中 未 被 跟踪 的 文件 ( 见 信 ) ， 因 为 我 

们 还 没有 告诉 它 要 跟踪 哪些 文件 。 接 下 来 ，Git 告 诉 

我 们 尚未 将 任何 东西 添加 到 当前 提交 中 ， 但 指出 了 可 
能 需要 加 入 仓库 中 的 未 跟踪 文件 ( 见 @) 。 


D.6 将 文件 加 入 仓库 中 
下 面 将 这 两 个 文件 加 入 仓库 中 ， 并 再 次 检查 状态 : 


@ git practice$ git add . 
@ git practice$ git status 
On branch master 


No commits yet 


Changes to be committed: 


(use "git rm --cached <file>..." to unstage) 
© new file: .gitignore 
new file: hello git.py 


git practices$ 


命令 git add . 将 项 目 中 未 被 跟踪 的 所 有 文件 都 加 入 
仓库 中 ( 见 @)。 它 不 提交 这 些 文件 ， 只 是 让 Git 开 
始 关 注 它 们 。 现 在 检查 项 目的 状态 时 ， 我 们 发 现 Git 
找 出 了 需要 提交 的 一 些 修 改 〈 见 外) 。 标 签 new file 
意味 着 这 些 文件 是 新 添加 到 仓库 中 的 〈 见 @) 。 


D.7 执行 提交 
下 面 来 执行 第 一 次 提交 : 


@ git practice$ git commit -m "Started project." 
@ [master (root-commit) ee76419] Started project. 
e© 2 files changed, 4 insertions(+) 

create mode 166644 .gitignore 

create mode 166644 hello git.py 


git practice$ git status 

On branch master 

nothing to commit, working tree clean 
git practices$ 


我 们 执行 命令 git commit -m "message "”【( 见 
@) 拍摄 项 目的 快照 。 标 志 -m 让 Git 将 接 下 来 的 消息 
("Started project." ) 记录 到 项 目的 历史 记录 
中 。 输 出 表明 位 于 分 支 master 上 ( 见 @) ， 日 有 两 
个 文件 被 修改 了 ( 见 @) 。 


现在 检查 状态 时 ， 会 太 现 我 们 位 于 分 文 master 上 ， 
且 工 作 树 是 干净 的 《〈 见 加) 。 这 是 你 每 次 提交 项 目的 
可 行 状 态 时 都 希望 看 到 的 消息 。 如 有 果 显 示 的 消息 不 是 
0 请 仔细 阅读 ， 很 可 能 是 你 在 提交 前 起 记 了 添 
和 文件。 


D.8 查看 提交 历史 
Git 记 录 所 有 的 项 目 提交 。 下 面 来 看 一 下 提交 历史 : 


git practice$ git log 

commit a9d74d87f1laa3b8f5b2688cb586eacla988cfc7f (HEAD - 
Author: Eric Matthes <eric@example.com> 

Date: Mon Jan 21 21:24:28 2019 -0966 


Started project. 
git practices$ 


每 次 提交 时 ，Git 都 会 生成 唯一 的 引用 ID， 长 40 字 

人 符 。 它 记录 提交 是 谁 执行 的 、 提 交 的 时 间 以 及 提交 时 
指定 的 消息 。 并 非 在 任何 情况 下 都 需要 所 有 这 些 信 
恩 ， 因 此 Git 提 供 了 一 个 选项 ， 让 你 能 够 打印 提交 历 
史 条 目的 更 简单 版 本 : 


git practice$ git log --pretty=oneline 
ee76419954379819f3f2cacafd15163ea966ecb2 (HEAD -> maste 


git practices$ 


标志 --pretty=oneline 指定 显示 两 项 最 重要 的 信 
息 : 提交 的 引用 ID 和 为 提交 记录 的 消息 。 


D.9 第 二 次 提交 

为 展示 版 本 控制 的 强大 威力 ， 我 们 需要 修改 项 目 并 提 
交 所 做 的 修改 。 为 此 ， 在 hello_git.py 中 再 添加 一 行 代 
但 : 


hello_git.py 


print("Hello Git world!") 
print("Hello everyone.") 


如 果 现 在 查看 项 目的 状态 ， 将 发 现 Git 注 意 到 这 个 文 
件 发 生 了 变化 : 


git practice$ git status 
@ On branch master 
Changes not staged for commit: 
(use "git add <file>..." to update what will be co 
(use "git checkout -- <file>..." to discard changes 


@ modified: hello git.py 


©® no changes added to commit (use "git add" and/or "git 
git practices$ 


输出 指出 了 当前 所 在 的 分 文 〈 见 辐 ) 和 被 修改 了 的 文 
件 的 名 称 〈 见 鳞 ) ， 还 指出 了 所 做 的 修改 未 提交 《〈 见 
全 ) .下 面 来 提交 所 做 的 修改 ， 并 再 次 查看 状态 : 


@ git practice$ git commit -am "Extended greeting." 
[master 51fofe5] Extended greeting. 
1 file changed, 1 insertion(+), 1 deletion(-) 

@ git practice$ git status 
On branch master 


nothing to commit, working tree clean 
@ git practice$ git log --pretty=oneline 


51fofe5884e6045b91c12c5449fabf4ad6eef8e5d (HEAD -> mas 
ee76419954379819f3f2cacafd15163ea966ecb2 Started proj 
git practices$ 


我 们 再 次 执行 了 提交 ， 并 在 执行 命令 git commit 时 
指定 了 标志 -am ( 见 @) 。 标志 -a 让 Git 将 仓库 中 所 
有 修改 了 的 文件 都 加 入 当前 提交 中 。 “如果 在 两 次 提 
区 之 间 创 建 了 新 文件 ， 可 再 次 执行 命令 git add . ， 
将 这 些 新 文件 加 入 仓库 中 。) 标志 -m 让 Git 在 提交 历 
史 中 记 录 一 条 消息 。 


碍 看 项 目的 状态 时 ， 我 们 发 现 工 作 树 也 是 干将 的 〈 见 
3 。 最 后 ， 可 以 看 到 提交 历史 中 包含 两 个 提交 〈 见 
) 


D.10 撤销 修改 


下 面 来 看 看 如 何 放 弃 所 做 的 修改 ， 恢 复 到 前 一 个 可 行 
状态 。 为 此 ， 首 先 在 hello_gitpy 中 再 添加 一 行 代 码 : 


hello_git.py 


print("Hello Git world!") 
print("Hello everyone.") 


print("Oh no, I broke the project!") 


保存 并 运行 这 个 文件 。 
我 们 查看 状态 ， 发 现 Git 注 意 到 了 所 做 的 修改 : 


git practice$ git status 

On branch master 

Changes not staged for commit: 
(use "git add <file>..." to update what will be com 
(use "git checkout -- <file>..." to discard changes 


modified: hello git.py 


no changes added to commit (use "git add" and/or "git 
git practices$ 


Git 注 意 到 我 们 修改 了 hello_git.py( 见 @)，。 如 果 愿 
意 ， 可 提交 所 做 的 修改 ， 但 这 次 我 们 不 提交 所 做 的 修 
改 ， 而 是 恢复 到 最 后 一 个 提交 我们 知道 ， 那 次 提交 
时 项 目 能 够 正常 地 运行 )。 为 此 ， 不 对 hello_git.py 执 
行 任 何 操作 (不 删除 刚 添加 的 代码 行 ， 也 不 使 用 文本 
编辑 器 的 搬 锁 功能 ) ， 而 是 在 终 问 会 话 中 执行 如 下 命 
ES 


git practice$ git checkout . 
git practice$ git status 
On branch master 


nothing to commit, working tree clean 
git practices$ 


命令 git checkout 让 你 能 够 恢复 到 以 前 的 任意 提 
交 。 命 令 git checkout . 放弃 最 后 一 次 提交 后 所 做 
的 所 有 修改 ， 将 项 目 恢复 到 最 后 一 次 提交 的 状态 。 


如 果 此 时 返回 文本 编辑 器 ， 将 发 现 hello_git.py 被 修改 
成 了 下 面 这 样 


print("Hello Git world!") 
print("Hello everyone.") 


就 这 个 项 目 而 言 ， 恢 复 到 前 一 个 状态 微不足道 ， 但 如 
果 我 们 开发 的 是 大 型 项 目 ， 其 中 数 十 个 文件 都 被 修改 


了 ， 那 么 恢复 到 前 一 个 状态 ， 将 撤销 上 自 最 后 一 次 提交 
后 对 这 些 文件 所 做 的 所 有 修改 。 这 个 功能 很 有 用 : 实 
现 新 功能 时 ， 你 可 以 根据 需要 做 任意 数量 的 修改 ， 如 
果 这 些 修改 不 可 行 ， 可 撤销 它们 ， 而 不 会 对 项 目 有 任 
何 伤害 。 你 无 须 记 住 做 了 哪些 修改 ， 因 而 不 必 手 工 撤 
销 所 做 的 修改 ，Git 会 但 你 完成 所 有 这 些 工 作 。 


注意 “要 看 到 以 前 的 版 本 ， 可 能 需要 在 编辑 器 
中 刷新 文件 。 


D.11 检 出 以 前 的 提交 


你 可 以 检 出 提交 历史 中 的 任何 提交 ， 而 不 仅仅 是 最 后 
一 次 提交 ， 为 此 可 在 命令 git check 末尾 指定 该 提交 
的 引用 ID 的 前 6 字符 (而 不 是 句点 ) 。 通 过 检 出 以 前 
的 提交 ， 你 可 以 对 其 进行 审核 ， 然 后 返回 到 最 后 一 次 
提交 ， 或 者 放弃 最 近 所 做 的 工作 并 选择 以 前 的 提交 : 


git practice$ git log --pretty=oneline 
51fofe5884e645b91c12c5449fabf4ad6eef8e5d (HEAD -> mast 
ee76419954379819f3f2cacafd15163ea966ecb2 Started proje 
git practice$ git checkout ee7641 

Note: checking out 'ee7641'. 


You are in 'detached HEAD' state. You can look around 
changes and commit them, and you can discard any comm 
state without impacting any branches by performing and 


If you want to create a new branch to retain commits 
do so (now or later) by using -b with the checkout co 


git checkout -b <new-branch-name> 


HEAD is now at ee7641... Started project. 
git practices$ 


检 出 以 前 的 提交 后 ， 将 离开 分 文 master ， 进 入 Git 所 
说 的 分 离 头 指针 (detached HEAD) 状态 ( 见 @)。， 
HEAD 指 针 表 示 当 前 提交 的 项 目 状 态 ， 之 所 以 说 处 于 
分 离 状 态 ， 是 因为 我 们 离开 了 一 个 命名 分 文 〈 这 里 

是 master ) 。 


要 回 到 分 支 master ， 可 检 出 它 : 


git practice$ git checkout master 

Previous HEAD position was ee76419 Started project. 
Switched to branch 'master' 

git practices$ 


| | 


这 让 你 回 到 分 支 master 。 除 非 要 使 用 Git 的 高 级 功 
能 ， 人 否则 在 检 出 以 前 的 提交 之 后 ， 最 好 不 要 对 项 目 做 
任何 修改 。 然 而 ， 如 果 参 与 项 目 开 发 的 人 只 有 你 自 
己 ， 而 你 又 想 放弃 较 近 的 所 有 提交 并 恢复 到 以 前 的 状 
态 ， 也 可 将 项 目 重 置 到 以 前 的 提交 。 为 此 ， 可 在 处 于 
分 文 master 上 的 情况 下 ， 执 行 如 下 命令 : 


@ git practice$ git status 
On branch master 
nothing to commit, working directory clean 
git practice$ git log --pretty=oneline 
51f6ofe5884e645b91c12c5449fabf4ad6eef8e5d (HEAD -> mast 
ee76419954379819f3f2cacafd15163ea966ecb2 Started proje 
git practice$ git reset --hard ee76419 
HEAD is now at ee76419 Started project. 


git practice$ git status 
On branch master 


nothing to commit, working directory clean 

git practice$ git log --pretty=oneline 
ee76419954379819f3f2cacafd15163ea966ecb2 (HEAD -> mast 
git practices$ 


首先 查看 状态 ， 确 认 位 于 分 支 master 上 ( 见 @) . 
查看 提交 历史 时 ， 我 们 看 到 了 两 个 提交 ( 见 @) 。 接 
下 来 ， 执 行 命令 git reset --hard ， 并 在 其 中 指定 
要 永久 恢复 到 的 提交 的 引用 TD 前 6 字符 ( 见 @) 。 我 
们 再 次 查看 状态 ， 发 现 位 于 分 支 master 上 ， 且 没有 
需要 提交 的 修改 〈 见 四 ) 。 再 次 查看 提交 历史 时 ， 会 
发 现 我 们 回 到 了 要 重新 开始 的 提交 〈 见 @) 。 


D.12 ”删除 仓库 


有 了 时候 ， 仓 库 的 历史 记录 被 你 弄 乱 了 ， 而 你 叉 不 知道 
如 何 恢复 。 在 这 种 情况 下 ， 你 首先 应 考虑 使 用 附录 C 
介绍 的 方法 寻求 帮助 。 如 宋 无 法 恢复 且 参 与 项 目 开 发 
的 只 有 你 一 个 人 ， 可 继续 使 用 这 些 文件 ， 但 要 将 项 目 
的 历史 记录 删除 一 一 删除 目录 .git。 这 不 会 影响 任何 
文件 的 当前 状态 ， 只 会 删除 所 有 的 提交 ， 因 此 你 将 无 
法 检 出 项 目的 其 他 任何 状态 。 


为 此 ， 可 打开 一 个 文件 浏览 器 ， 并 将 目录 .git 删 除 ， 
也 可 通过 命令 行将 其 删除 。 这 样 做 后 ， 需 要 重新 创建 
一 个 仓库 ， 重 新 对 修改 进行 跟踪 。 下 面 演示 了 如 何在 
终端 会 话 中 完成 这 个 过 程 : 


git practice$ git status 

On branch master 

nothing to commit, working directory clean 

git practice$ rm -rf .git 

git practice$ git status 

fatal: Not a git repository (or any of the parent dir 
git practice$ git init 

Initialized empty Git repository in git practice/.git 
git practice$ git status 

On branch master 


No commits yet 


Untracked files: 
(use "git add <file>..." to include in what will be 


.gitignore 
hello git.py 


nothing added to commit but untracked files present ( 
git practice$ git add . 
git practice$ git commit -m "Starting over." 

[master (root-commit) 6baf231] Starting over. 

2 files changed, 4 insertions(+) 

create mode 166644 .gitignore 

create mode 166644 hello git.py 


@ git practice$ git status 
On branch master 
nothing to commit, working tree clean 
git practices$ 


首先 查看 状态 ， 发 现 工作 树 是 干净 的 ( 见 @) . 接 下 
来 ， 使 用 命令 rm -rf .git (在 Windows 系 统 中 ， 应 
使 用 命令 rmdir /s .git ) 删除 日 录 .git( 见 @) 。 
删除 文件 夹 .git 后 再 次 查看 状态 时 ， 我 们 被 告知 这 不 


是 一 个 Git 仓 库 ( 见 @) 。Git 用 来 跟踪 仓库 的 信息 都 
存储 在 文件 夹 .git 中 ， 因 此 删除 该 文件 夹 也 将 删除 整 


个 仓库 。 


接 下 来 ， 使 用 命令 git init 新 建 一 个 全 新 的 仓库 

( 见 @) 。 然 后 查看 状态 ， 发 现 又 回 到 了 初始 状态 ， 
等 待 着 第 一 次 提交 ( 见 @) 。 我 们 将 所 有 文件 都 加 入 
仓库 ， 并 执行 第 一 次 提交 ( 见 @) 。 然 后 再 次 查看 状 
态 ， 发 现 我 们 位 于 新 的 分 文 master 上 ， 且 没有 任何 
未 提交 的 修改 〈 见 @) 。 


你 需要 经 过 一 定 的 练习 才能 学 会 使 用 版 本 控制 ， 但 一 
旦 开始 使 用 ， 你 就 再 也 离 不 开 它 了 。 


后 亿 


祝贺 你 ! 你 学 习 了 Python 基本 知识 ， 并 利用 这 些 知识 
创建 了 一 些 有 意义 的 项 目 : 创建 了 一 款 游 戏 ， 对 一 些 
数据 进行 了 可 视 化 ， 还 创建 了 一 个 Web 应 用 程序 。 现 
在 ， 你 能 通过 众多 不 同 的 方式 进一步 提高 编程 技能 


首先 ， 应 该 根据 自己 的 兴趣 继续 开 太 有 意义 的 项 目 。 
当 你 通过 编程 来 解决 重要 的 相关 问题 时 ， 编 程 将 更 具 
吸引 力 ， 而 且 现 在 你 具备 了 开发 各 种 项 目 所 需 的 技 
能 。 你 可 以 开发 自己 的 游戏 ， 也 可 以 开 友 模仿 经 典 街 
机 游戏 的 游戏 。 你 可 能 想 研 究 一 些 对 你 来 说 很 重要 的 
数据 ， 并 通过 可 视 化 方法 将 其 中 有 趣 的 规律 和 关系 展 
示 出 来 。 你 可 以 创建 目 己 的 Web 应 用 程序 ， 也 可 以 答 
试 模拟 自己 喜欢 的 应 用 程序 。 


只 要 有 机 会 ， 就 邀请 别人 尝试 你 编写 的 程序 吧 。 如 果 
你 编写 了 游戏 ， 就 邀请 别人 来 玩 一 玩 ;， 如 果 你 创建 了 
图 表 ， 束 同 别人 展示 展示 ， 看 看 他 们 能 人 否 看 明日 ， 如 
果 你 创建 了 Web 应 用 程序 ， 束 将 其 部 团 到 在 线 服务 
器 ， 并 邀请 别人 尝试 使 用 。 听 听 用 户 怎 么 说 ， 并 努力 
0 ee 
星 序 员 。 


自己 动手 开发 项 目 时 ， 你 肯定 会 遇 到 环 手 乃至 无 法 解 
决 的 问题 。 请 想 办 法 寻求 帮助 ， 并 加 入 合适 的 Python 
社区 。 加 入 当地 的 Python 用 户 组 ， 或 者 到 一 些 在 线 
Python 社区 和 逛 逛 就 很 不 错 。 另 外 ， 考 虑 参加 附近 举办 
的 Python 开 发 者 大 会 (PyCon) 。 


你 应 尽力 在 开发 目 己 感 兴趣 的 项 目 和 提高 Python 技能 
之 间 取 得 平衡 。 网 上 有 很 多 Python 学 习 资 料 ， 市 面 上 
还 有 大 量 针 对 中 级 程序 员 编 写 的 Python 图 书 。 现 在 你 
掌握 了 基本 知识 ， 并 且 知 道 了 如 何 应 用 学 到 的 技能 ， 


因此 能 看 懂 其 中 的 很 多 资料 。 通 过 阅读 教程 和 图 书 积 
累 更 多 的 知识 ， 加 深 你 对 编程 和 和 Python 的 认识 吧 。 深 
入 学 习 Python 后 再 去 开发 项 目 时 ， 你 将 能 够 更 高 效 地 
解决 更 多 的 问题 。 


祝 痪 你 在 学 习 Python 的 道路 上 走 了 这 么 远 ， 愿 你 在 以 
后 的 学 习 中 有 好 运 相伴 ! 


入 
作者 简介 
埃 里 元 : 蕊 瑟 斯 (Eric Matthes ) 
高 中 科学 和 数学 老师 ， 现 居住 在 阿拉 斯 加 ， 在 当地 讲 


他 从 5 岁 开 始 束 一 直 在 编写 程 
了 了 。 


看 完了 


如 果 您 对 本 书 内容 有 疑问 ， 可 发 邮件 至 
contact@turingbook.com， 会 有 编辑 或 作 译 者 协助 答 
疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮 


箱 : ebook@turingbook.com。 

在 这 里 可 以 找到 我 们 : 

微 博 @ 图 灵 教 育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精彩 
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